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WELCOME 
to The MagP1 113 


still remember picking up my first Raspberry Pi 





computer like it was yesterday. | built a small two- 

wheeled robot and got all the likes on Facebook. 
One thing led to another, and here | am editing this 
incredible magazine. 





Lucy 





Everybody has to start somewhere, and this month Hattersley 
we’ve put together a Get Started with Raspberry Pi feature Lucy is editor of 
(page 30). This article helps newcomers put together a aero 
Raspberry Pi, install the Raspberry Pi OS operating system, tin eens 
and discover basic electronics with GPIO. It’s perfect for Spee nee pet 


magpi.cc 


Raspberry Pi newbies. 

We’ve also got the best Starter Kits (page 82) and some 
ereat beginner-friendly tutorials. Whether it’s creating 
Pong controllers (page 40), building a binary clock (page 58), 
or using sensors to build your own Weather Station (page 
50), there are some great ideas here for Raspberry Pi fans. 

Rob has also put together a great feature on Gaming with 
Raspberry Pi (page 68). a 
Not retro gaming, but the ary PI MAGAZINE | 
full-on, ohaeacided Lyon Ce @ 
games you can play with an 
amazing $35 computer. 

Raspberry Pi comes from — ————ae 
humble beginnings, but | i Ua | 1) 
every month it gets better. | : as finda 
We can’t wait to see what | - - TLLSE} 
Raspberry Pi does in 2022! | = | | Pde Ka 









Lucy Hattersley Editor 
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oe FASPRERRY PI GAMING SPECIAL! 


magpi.cc | 03 








Wh LWAVESHARE 


Sale astne ly ietsrelpalsme alelaelyiela> 





Designed for Raspberry Pi Compute Module 4 


PoE/loT/Dual Gigabit ETH Base Boards for CM4 


Various Mini-Computers Based on CM4 


CONTENTS | Maghi 


Contents 


> Issue 113 » January 2022 


Cover Feature 





30 Raspberry Pl new 
user guide 2022 


) Regulars. 


92 Your Letters 
97 Next Month 
98 The Final Word 


Project Showcases 


08 Old School Minitel Laptop 
12 PicoLight 

14 Big Boxes 

18 Virtual birthday cake 

22 Environmental cargo logger 









24 Super 8 Kamera 





Old School Minitel Laptop PicoLight 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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Home projects made easy. 
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Old School 
Minitel Laptop 


From Minitel to ag near-mini laptop, Gautier Serodon has repurposed a terminal once 
used for France's innovative online service in the 1980s, ds David Crookes explains 








Gautier 
Serodon 


Gautier is an 
engineering student, 
as well as an 
electronic and DIY 
enthusiast. He enjoys 
retro tech, vintage 
cars, watchmaking, 
3D printing, and 
board games. 


magpi.cc/minitel 


Wide Web, France had a hugely popular 

telecommunications service called Minitel. 
It allowed the country’s citizens to book train 
tickets, check their electronic mail, search the 
telephone directory, and access online banking 
among other things, attracting an estimated 
25 million users and offering around 26,000 
services at its peak. 

Launched in 1982 and remaining in use for 
exactly 30 years, it was far ahead of its time. 
Anyone who wanted a terminal to connect to 
Minitel could get one for free from what became 
France Télécom, and this led to 9 million sets 
being installed in homes by 1999. But since Minitel 
closed, many have ended up being sold. “It’s easy 
to find a terminal on sale for below €10,” says 
French maker Gautier Serodon. 

Having snapped one up himself at a garage sale, 
the 25-year-old decided to bring it back to life. “I 
love retro tech and I wanted to revive my Minitel 
with today’s technology,” he says. He decided a 
Raspberry Pi 3B computer would enable him to do 
just that. “It’s affordable, compact, and internet- 
compatible,” he explains. And the plan? To convert 
it into a battery-powered laptop so he could take 
notes during his engineering school classes. 


p rior to the development of the World 


Key to authenticity 
Gautier bagged himself a Minitel 1B terminal, 
made in 1982 by Telic Alcatel. He stripped it of 
most of its parts, including the CRT display, but 
decided he wanted to at least retain use of the 
terminal’s original — and satisfyingly clicky - 
AZERTY keyboard. 

He also kept the power button and power 
indicator. “I wanted to keep as much of this 
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A lt may not the sleekest of ‘laptops’, but his charmingly 
bulky piece of retro kit is still portable 


charming old technology as possible,” he tells us. 
“The power button and the LED played an important 
role in maintaining the aesthetics of the Minitel.” 
The screen was replaced by a 10.4-inch LCD 

panel which came complete with a driver board and 
this was fixed within the Minitel casing using four 
3D-printed parts, one for each corner. The biggest 
challenge, however, involved retrofitting the old 
Minitel keyboard so that it would simulate a USB 
HID keyboard that Raspberry Pi could work with. 
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Minitels were first used 
to find phone numbers 


Thousands more 
services were 
later added 


The World Wide 
Web rendered 
Minitel obsolete 


A small number of 
QWERTY terminals 
were made 


This project is 100 
percent open-source 


The project runs Raspberry Pi OS, 
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Warning! 
CRT 


Be careful with projects 
involving old television 
and CRT equipment. 
Opening up a CRT can 
be dangerous, risking 
electric shock even if the 
TV is not plugged in. 


magpi.cc/crt 


P Here you can see 
the internal wiring, 
connecting the 
screen (Laid flat) to 
Raspberry Pi fixed to 
the right of the case 


V_ AnHDMI cable 
connects Raspberry 





Pi to the display. You 
could easily upgrade A Given it dates back to 1982, Gautier’s Minitel terminal - 
to Raspberry Pi 4 bought from a garage sale - is in surprisingly good condition 


VL 
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01 The bulk of the electronics are behind the 
Minitel’s screen and need to be removed. A 
new screen is fixed using printed parts. STL files of 
these are provided by Gautier. 


M |t's possible to plug an Ethernet cable 
directly into Raspberry Pi too @ 


A This is the keyboard 
matrix Gautier used, 
with eight columns 
and eight rows 


“The Minitel keyboard is a matrix with a17- 
wire output cable,” Gautier explains. “When you 
retrofit a matrix keyboard, the goal is to find the 
wires of the columns and the wires of the rows - in 
this case, there are eight rows and eight columns, 
making a keyboard with a maximum of 64 keys.” 


Looking rosy 
Gautier used an Arduino Pro Micro which has an 
ATmega32U4 microcontroller on board. “This is 
the easiest way to emulate a keyboard,” he says. 
“Other boards such as the Arduino Nano don’t 
have the same microcontroller, so it’s way more 
difficult to simulate a keyboard without modifying 
the bootloader and other things.” 

From this point, the main work involved fixing 
a Raspberry Pi in place and connecting it to the 
keyboard, a DC step-down converter, and the 
power switch. “I placed Raspberry Pi right behind 
the Minitel’s hatch [located behind the screen] 
so that it is easy to plug in a dongle for a wireless 
mouse,” Gautier says. “It’s possible to plug an 
Ethernet cable directly into Raspberry Pi too.” 

All in all, it makes for a very neat setup, one that 
is powered by a 12V Li-ion rechargeable battery for 
portability. Gautier doesn’t attempt to emulate the 


<2 ’ > 
- “oer, 


02 A Minitel contains a simple matrix keyboard. 

The matrix is constantly scanned, allowing it to 
detect when a key is pressed and a circuit is closed. 
It must be mapped. 





t—hn 
ram 3! 


UI of an old Minitel system - “I’m simply running 
Raspberry Pi OS,” he says — but it still gives a 
flavour of what it was like to use the system. “It’s 
just a shame | never had the chance to use a Minitel 
for its original applications,” he laments. 





03 Now the case can be kitted out with Raspberry 
Pi (in a 3D-printed case), a battery, a light 
indicator, and power supplies. Hot glue is used to afhx 
the components. 
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PicoLight 


If you need an adjustable light, this neat little project might 
illuminate the way. Nicola King admires a glowing make 








Alexandra 
Covor 


A maker and 
embedded 
engineer from 
Bucharest, 
Romania. She 
loves playing with 
microcontrollers 
and blinky LEDs, as 
well as combining 
beauty and 
functionality when 
designing PCBs. 


zalmotek.com 


> Raspberry Pi Pico is 


surface-mounted 
on the rear of the 
NeoPixel matrix PCB 
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s active members of the open-source 
A hardware community, Bucharest-based 
makers Alexandra Covor, Constantin 
Craciun, and Mihnea Stoica regularly post project 
tutorials for the wider community. Impressive 
images of their projects are essential in order to 
ignite interest. However, finding the right light 
to shine on their endeavours was becoming a 
challenge, so like all good makers, the team decided 
to make their own. 
PicoLight is the result — a Raspberry Pi Pico- 
based, minimalist adjustable light which is 
perfect for low-light photography, as project lead 
Alexandra shares: “Studio lights are great, but 
they are often too big and too bright for our tiny 
[hardware] projects, so this is where PicoLight 
comes in, being ideally sized.” 


Small but mighty 

Alexandra describes PicoLight’s user experience 

as “pretty simple”. It’s made up of two fully 
customised PCBs and an acrylic panel sandwiched 
together. One PCB is a LiPo battery shield including 
a charging circuit and a power switch, while the 
other PCB is a 4x4 NeoPixel matrix with a Raspberry 
Pi Pico soldered onto the back. It also features a 
rotary encoder with a push-button, “used to switch 
between the functioning modes: colour adjustment, 
brightness adjustment, and rainbow mode, in 
which the LEDs cycle through all the colours.” 








A The 4x4 NeoPixel matrix in rainbow cycle mode 


The team initially connected an external battery 
to Pico’s micro USB port, but Alexandra says that 
they soon realised that portability was key, “so we 
ended up designing our own battery shield as well.” 


™ Some of our photographer 
friends asked for PicoLights 
to use in their shoots @ 


All of this has resulted in a very neat-looking and 
compact end product. As the PicoLight measures 
just 52*52mm, they were a little concerned about 
how they would fit all of the features on it, but 
“then it hit us that we can actually build vertically, 
and add a new layer for every new feature we want 
to integrate, such as the battery charging module,” 
says Mihnea. 

They’ve found it a useful tool on a day-to-day 
basis and while PicoLight’s main purpose is adding 
a “dash of colour to macro photography... we’ve 
also used it to add a rather nice touch to video 
calls,” Mihnea adds. 


In the limelight 

The response to PicoLight received so far has been 
hugely encouraging. “PicoLight ended up being 
much more popular than we’ve expected,” says 
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PicoLight took 
three months 
to develop 


Components 
include a Raspberry 
Pi Pico along with... 


Alexandra. “Some of our photographer friends 
asked for PicoLights to use in their shoots.” 
While considering a few improvements, 


the support of the community is so good. We’re 

also actively giving back whenever we can by open- 

sourcing our [Raspberry] Pi-based projects.” 

including the possibility of using the RP2040 chip If you'd like to try and make your own PicoLight, 

on acustom board rather than the entire Pico, step-by-step instructions are available on Hackster 

Constantin tells us that since the feedback hasbeen (magpi.cc/picolightguide), and Mihnea thinks 

SO positive, and everybody asked where they can that any intermediate-level maker with a hot 

buy it, they are pondering crowdfunding the project —_ plate or DIY reflow oven would be able to achieve 

to bring it to mass production. this make, as the right tools “make short work of 
The team are well-accustomed to using this project.” H 


a Custom acrylic 
panel, and rotary 
encoder with 
push-button 


The software run 
by Pico Is written in 


Raspberry Pi boards in their projects. “We have 
worked a lot with Raspberry Pi development 
boards for various IoT projects,” says Constantin, 
“like automated points of sale, magic mirrors, 
and automated crypto trading bots to name a 
few, and we are excited about exploring the Pico 
microcontroller range.” 

They have also, generously, made this project 
open-source, as Constantin explains: “We foresee 
using the Raspberry Pi variants in lots of future 
projects since they offer so much flexibility and 


CircuitPython 


See some of the 
team's projects 
at magpi.cc/ 
zalmotek 


<The NeoPixel PCB is 


sandwiched between 
an acrylic diffuser 
panel and the LiPo 
battery shield 
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Big Boxes 





Rich 
Thanki 


The possibilities 

of wireless 
connectivity led 
community- 
minded Rich, a 
self-confessed 
electronics tinkerer, 
to co-found a non- 
profit helping others 
get online. 


janga.la 


Each box provides 
secure wireless 
access, weighs just 
1.9kg, and fits ina 
small backpack 


Asm 
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Social enterprise Jangald provides internet access to communities 
affected by disasters. Rosie Hattersley hears their big idea 


natural disasters, web access provides a 
critical lifeline. 

Not-for-profit organisation Jangala provides 
internet access for displaced people. The 
organisation was born out of its founders’ 
involvement in humanitarian relief efforts. These 
included the Amatrice earthquake in central Italy 
in 2016 and supporting refugees living in Camp de 
la Lande, Calais. 

Jangala’s ruggedised Big Boxes provide web 
access in challenging environments and, witha 
recent Raspberry Pi upgrade, are now capable of 
offering connectivity to multiple users via almost 
any wireless means. Their mission is to connect 


. or communities affected by man-made or 





every school, clinic, and community resilience 
project worldwide. In 2019, the project wona 
Tech4Good Africa award, having supplied internet 
access to 50 students at a refugee camp in Kenya, 
enabling them to complete their diplomas. 


The Big Easy 

Jangala co-founder and head of technology Rich 
Thanki has been fiddling with gadgetry and taking 
electronics apart “as long as I can remember”. 

A huge fan of wireless technology, Rich worked 
on projects with Microsoft bringing connectivity 
to people in sub-Saharan Africa before founding 
Jangala with Samson Rinaldi, who managed the 
CAD and hardware design aspects. 

Each Big Box is a briefcase-sized device, 
designed to be simple to set up and take advantage 
of an available wireless connection to offer WiFi 
access to hundreds of users at a time. “Scalable 
high-quality WiFi without the need for costly 
technical expertise” characterises Jangala’s single- 
box approach to providing internet access when 
and where it may be needed. 

This is the first of Jangala’s projects to use 
Raspberry Pi products. “I think the first of many,” 
says Rich. 

Jangala’s updated purple box is now faster, more 
capable, and more rugged, the team explains, with 
the wireless antennas having been moved inside 
the box to protect them from the elements, plus 
twin modems that allow Big Box to connect to 
networks ranging from 2G networks to 5G. It was 
largely this aspect that prompted the switch to 
Raspberry Pi since it can handle the gigabit speeds 
that 5G networks offer. 





Jangala has set 
Up 20 Big Box 
installations so far 


They provide web 
access to more 
than 25,000 users 


Jangala’s Get Box 
provided UK users 
with web access 
during lockdown 


Each Big Box has a 
4G global modem 


It can also connect 
via satellite 
7 : 
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4 Deployments include 


refugee camps such 
as this one for exiled 
Rohingyans 

Credit: DFID, Rakhine 
camp, Myanmar 


Delivery of Big Boxes at 
Kakuma refugee camp, 
Kenya, where they will 
help support women 
and disadvantaged 
youths gain education 
and employment 





Other components were sourced from “absolutely 
all over the place”, but the use of OpenWRT 

and the support of the Linux community were 
absolutely crucial. Rich also credits amazing 
manufacturers in China who designed the 
incredibly useful things that can’t be found 
anywhere else, “everything from the perfect boost 
converter to little waterproof slots for SIM cards”. 


mM Without the stable base 
provided by Raspberry Pi, 
things would've gotten 
hairy guickly 


Tech for good 

“The role of Raspberry Pi in Big Box is essentially 
to run the show,” says Rich. “It’s really the 
brains and brawn of the system. We are able to 
control and see Big Boxes in the field by talking to 
Raspberry Pi. It routes every bit of traffic, which 
is no easy feat. We’ve a unique software setup to 
ensure security and it’s remotely updatable, so we 
have to use U-Boot as a second-stage bootloader. 
Without the stable base provided by Raspberry Pi, 
things would’ve gotten hairy quickly.” 
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Big Box basics 
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01 Each Big Box provides internet access 
for more than 100 users, with additional 

connections added via extra radio controllers. 

Raspberry Pi provides the “brains” of each box. 









02 The setup includes a PoE (Power over 
Ethernet) switch, a 4G global modem, and 

wireless access point, plus bespoke, highly efficient 

power management. 


Rich says working with Raspberry Pi 4 has been 
ereat because of the community, really accessible 
documentation, and standards that are open- 
source. “It’s made a huge difference for us. We 
wouldn’t have been able to do this on any other 
device,” he notes. 

Although Big Box is Jangala’s first Raspberry Pi 
experience, it won’t be their last. “Our next two 
projects will tackle other aspects of infrastructure 
which are really important in humanitarian 
settings, mainly power and edge computing. In 
both these cases, Raspberry Pi provides things that 
could easily be at the heart of these projects.” 


For anyone else planning on designing products 4 Big Box and Lenovo devices 
support online education 












for social good, Rich says, “Focus on what you have courses in Kalobeyei 
to do to get the design into the hands of people ecm ome TE) Due to the demanding locations in which 
and making a difference as soon as possible. This £ Tsbeetiodsinenal Big Boxes are deployed, the ruggedised 


boxes need to be fully waterproof, including their 


might run against the grain of people who want ae to anny : fence 

rerugees, ana remote connectors an anas. 
to be perfect and neat. Don’t let the perfect be the eee oe : 
enemy of the good.” a 
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Virtual 
birthday cake 


This virtual birthday cake hides a delicious surprise, although 
Rob Zwetsloot had to settle with the Minecraft-powered part 








Stephen 
Thompson 


A research engineer 
at the Wellcome/ 
EPSRC Centre 

for Interventional 
and Surgical 
Sciences, and Code 
Club mentor. 
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sthompson 


> The building of the 


cake is a serious and 
exact procedure. 





hile some (us) might argue that the best 
W part of a birthday cake is the cake itself, 
there’s definitely something to be said 
for an interactive model cake that does stuff in 
Minecraft. Also, there is a real cake underneath it 
all after you’ve finished with the virtual stuff. 
“The virtual cake consists of a looping video 
of a cake created on Minecraft with nine candles 
that can be blown out by spinning miniature wind 
turbines on a matching physical model cake,” 
Stephen Thompson, the creator of this cake, tells 
us. “Once all the candles are blown out, the birthday 
child can lift the model cake to reveal an edible cake 
which is mercifully free of children’s saliva.” 
Sounds a bit more tasty and clean when you put 
it that way. 
“T have always enjoyed making my children’s 
birthday cakes, with a firm belief that form and 
function are as important as flavour,” Stephen 
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explains. “In 2021, I was faced with the problem of 
not being able to blow out candles on the cake... A 
virtual cake controlled by miniature wind turbines 
seemed the obvious solution. I’d recently started 
developing web applications for research and 
education in surgery, so it made sense to reuse these 
skills for the virtual cake.” 


Virtualising baked goods 

While something like this could be in some way 
achieved in Minecraft Raspberry Pi Edition, that was 
not why a Raspberry Pi was used. 

“Raspberry Pi provided an easy way to interface 
with the analogue-to-digital converters needed 
to read the wind turbine voltages,” Stephen says. 
“Along with sufficient computing power to serve a 
web application from within the cake itself, using 
Raspberry Pi enabled me use the same software 
architecture (Python, Flask, HTML) as I have used 
professionally. Sourcing the right HAT to measure 
nine voltages was very easy.” 

The virtual cake instead uses looping video 
overlaid with candle GIFs served via a web app ina 
clever way, as Stephen explains: 

“The application uses Flask to serve a web page 
which any device on the local network can access... 
a JavaScript loop is used to repeatedly send a POST 
request to the web server asking for the voltage 
from one of nine analogue-to-digital converters 
(the ADC board can support up to 16 candles). The 
code to interface with the ADCs and reply to the 
POST requests is written in Python and utilises the 
Flask and gpiozero libraries. All the code is available 
on GitHub (magpi.cc/sthompson).” 
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> The model cake 
was built from 
Spare pieces 
of wood 


> Stephen's son, 
Samuel, built the 
Minecraft version 


> Stephen's work 
helps develop 
augmented reality 
software for 
Surgeons... 


> .. that aims to 

ai at-melfelit-\mer-Vale|Co1= better utilise open- 

eV a-m o) Kova melel im o)\ source software 

'o)Ke)v alate meal to create open 

the turbines and reproducible 

“ science 

These Little turbines — 

will spin when blown a SS > The wind turbines 

upon, which is sensed _ | = - are actually mini 

by the system = a —a generators for 
‘adil = education 


4 The guests quickly 
figured out what they 
had to do to blow out 
the candles 
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Sawing the wood for 
the model and the 
mini wind turbines 


There is space under 
the model cake for the 





electronics and the 


real cake 
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Virtual birthday cake 








| was slightly nervous 
that the children would 
find it too abstract, 
Dut they worked it out 
pretty guickly 


Proof in the dessert 

Despite the best efforts of developers, sometimes 
an interface is not always clear to the user — 
especially when they’ve just turned nine. 

“T was Slightly nervous that the children would 
find it too abstract, but they worked it out pretty 
quickly,” Stephen mentions. “They saw the 
connection between the plastic wind turbines on 
the cake and the candles on the screen, and worked 
out that you could turn the on-screen candles off 
by blowing on the wind turbines. There was much 
laughter and smiles. The children were also very 
pleased to discover that there was actual cake 
underneath it all.” 

If only there were cake underneath every 
interactive Raspberry Pi project. 
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01 Blowing on the wind turbines generates 
a small amount of voltage, enough to be 
detected as a change using an ADC. 











A Asmall mess of wires 
ready to be hooked 
up to Raspberry Pi 


> The model was made 
from scratch 


02 A script that continually checks the voltage 
of each turbine written in JavaScript will get a 
response from Raspberry Pi via Python and Flask. 












03 If voltage is detected from a turbine, it means 

it's being blown on, and the candles are ‘blown 
out’ in Minecraft by changing the animation that is 
being presented. 
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Environmental 
cargo logger 


Keeping sweet potatoes sweet using data from a Raspberry PI 
data collector, Rob Zwetsloot checks the results 





Thinus 
Prinsloo 





A Regional Manager 
for an IT company 
who doesn't have to 
code any more but 
still enjoys doing it. 


> The components are 
all spread out inside 
the container 


the Netherlands takes a while. It’s a long 

way, and one farm wanted to figure out what 
the potatoes went through on their 40-or-so day 
journey. This is where Thinus Prinsloo came in. 

“T was approached [by Zilverstoom Farms] to 
come up with a solution to monitor a cargo of sweet 
potatoes on their sea voyage to the Netherlands,” 
Thinus tells us. “They wanted a visual record of 
the inside of a cargo bay for the duration of the sea 
voyage. The idea was to put a logger ina bin with 
sweet potatoes and log the environment in the bin 
for 40+ days, taking daily photos of the cargo. Once 


G etting sweet potatoes from South Africa to 
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the logger arrived in the Netherlands, the data 
were collected from the USB drive and sent back to 
Zilverstroom Farms.” 

For this project’s requirements, a Raspberry Pi 
Zero became the obvious choice for Thinus. 

“There are numerous commercial environment 
loggers on the market to monitor cargo, but the 
client also wanted to have a visual record of the 
whole sea voyage. The requirements for the logger 
system were: to be powered by battery, low power 
consumption, low component costs, to allow the 
use of custom programming code, [and] consist 
of easy-to-come-by, off-the-shelf components. 
They also wanted flexibility — the ability to reuse 
the system components for other projects in the 
future. The sensor readings and photos would also 
be stored on a USB flash drive for easy collection... 
Raspberry Pi Zero checked all the boxes for the 
above requirements.” 


Potato stats 

Running continuously for 40 days is no real 
problem for a Linux-powered box like Raspberry Pi 
— there are several out there that have logged over 
1000 days’ uptime — however, there’s no handy 
plug socket for Raspberry Pi to use here. 

To conserve as much power as possible, a PiJuice 
HAT with a power supply and a real-time clock was 
used to power on the system once a day for just five 
minutes to do its job. 

“Once Raspberry Pi was switched on, the 
temperature, humidity, and atmospheric pressure 
readings were taken and written to the USB flash 
drive,” Thinus explains. “As a failsafe, the data is 
also written to the SD card of Raspberry Pi.” 

Thinus describes it working as follows. 

During the start-up process, crontab events 
at reboot are scheduled to: 
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> Thanks to a mobile 
battery, the logger 
can operate for 


50 days 

A Raspberry Pi > Otherwise, with just 

Camera Module takes |g PiJuice, it runs for 

relate) KoSW-Youl of-1a Mey tal) up to 30 days 

X=) alse) mig revellare is 

Lights are used —_ | > Pi Juice will only 
to illuminate the a — _ wait for ten minutes 
potatoes when ae ee | for Raspberry Pi 
photos are taken . Cy Zero to turn on 


> An enclosure was 
laser-cut for 


the project 
Oy atex=e- me l= \Vamaal= 
system is turned on > Some people call 
to take readings sweet potatoes 


yams, but they are 
not true yams 


4 Photos show how the 
inside of the container 
looks during the journey 





° Take a photo after 45 seconds using a Bash 

Script to: 

- Switch on the bright LED and take a photo 
with the Pi camera and save it to the SD card 

- Switch off the bright LED and switch on the 
infrared LED 

- Take an infrared photo with the camera and 
save it to the SD card 


4 The potatoes and 
logger are ready for 
the long journey 





- Copy the photos to the USB drive Tuber analysis 
Using results from the logger, the farm has put 
e Read the sensor data after 30 seconds witha measures in place to reduce transit time for their 
Python script: sweet potatoes. The data also revealed some 
- Write the measurements for the interesting stats, such as the big temperature shifts 
temperature, humidity, and atmospheric mainly occurring on the 1000 km journey from the 
pressure to a log file on the SD card farm to the harbour, and the unloading of the cargo at 
- Copy the log file to the flash drive the destination. The potatoes also noticeably shrank 
over the course of the journey. 
° Set the PiJuice shutdown trigger for shutting “Tt worked very well, and for longer than 
down using a Python script. anticipated,” Thinus mentions. fH 
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super 8 
Kamera 


Switching film for Raspberry Pi-based digital 
Capture transformed one creator's videography, 
as he relates to Rosie Hattersley 


2000s, there was an abrupt switch from 

film to digital photography and video, 
but there are plenty of analogue cameras and 
video cameras still around, and some that 
even earlier recording methods, such as 8mm 


D ver just a few short years in the early 








we 3 
©, 


Bennet Fischer 


With a PhD in 
robotics anda 

day job working 

on mapping and 
camera-based 
assistance, Bennet's 
an accomplished 
coder and 

keen upcycler. 


github.com/ 
befinitiv 


cassette. Photography and film enthusiast Bennet 
Fischer spied an opportunity to retrofit his old 
film cameras and camcorders and go digital using 
Raspberry Pi, resulting in the Super 8 Kamera, 


M An electronic film cassette 
that can be plugged Into 
any Super 8 camera and 
make it usable again @ 


one of several upcycling projects he’s undertaken. 
Modernising retro tech items is satisfying, he 
explains, “not only because it makes them useful 
again, but also because of the unique experience”, 
citing his enjoyment of programming Python web 
applications on a 286 laptop, or live-streaming full 
HD video on a 50-year old SLR camera. 

Bennet is lucky enough to have a job that 
involves imagination, invention, and problem- 
solving. An engineer and professor of robotics, 
his role involves work developing mapping and 
camera-based assistance programs. In his free 


24 | magpicc | Super 8 Kamera 


a 
it 


PANae)e) t(or-| msx~) alsye) me (=10-(el mM aT~ a 
the camera is moving, after the 
ig=xexo) co ol like) a al- (om ol=\-1al e)a=ss1-\-10. 





time, he focuses on building projects that spark his 
curiosity. “Raspberry Pi is a perfect platform for 
such projects because it eliminates most burdens 
that come with building embedded devices,” he 
says, citing the “excellent” Raspberry Pi and open- 
source software communities. 


Mechanical marvels 

Super 8 cameras are “mechanical marvels that are 
destined to sit unused in drawers simply because 
you cannot buy the film cassettes any more,” 

he opines. And if you could, he calculates three 
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Raspberry Pi Zero W anda 5MP 
Raspberry Pi Camera replace 
ival-me)alelial-\millaamerslanalelel= 
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Super 8 camera back into use 





> Bennet enjoys 
finding new ways 
of using old 
technology 





> The Super 8's 
original battery had 
leaked badly 


> He had to cut 
out and replace 
most of the 
original wiring 


> The camera 
attracted attention 
because it was 
quite noisy 


> Few people 


< Replacing the obsolete recognised what 
8mm recording medium fhe Supers 
results in instantly viewable p 
30 fps video capture camera Was 
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Movie making makeover 





This project uses Raspberry Pi Zero W, a 
Raspberry Pi Camera, and Bennet’s adapted 
version of the picamera API code. Download the 
code from magpi.cc/campy, and the CAD files from 
magpi.cc/digital8cad. You'll also need an external 
power bank. 





A With no post-processing, the 
results have a similar patina 
bare sensor chip. Be aware that cutting away to decades-old photos develop. Troubled by this wasted potential, Bennet 


Trim down your Raspberry Pi Camera to the minutes of footage would cost around €60 to 


its plastic parts with a craft knife requires patience, 
precision, and care. 


decided to create “an electronic film cassette that 
can be plugged into any Super 8 camera and make 
it usable again.” He used Raspberry Pi Zero W with 
a5MP camera mounted on a flex circuit board. He 
chose Raspberry Pi for the Zero W’s compact size 
and low price, plus the “excellent software support 
of camera and video encoder hardware.” He was 
also attracted by the possibility of adding wireless 
live video streaming. 

Another important factor was that Bennet had 
recently put together a very similar project for an 
SLR still camera — involving fitting a Raspberry Pi 
Zero W completely inside the camera — which had 
proved popular (see magpi.cc/digitalfilmcart). He 





See the instructions at magpi.cc/super8video 


for details of how to complete the setup, hoped to use the same idea for the Super 8 camera. 
including the photoresistor and motion-detecting LED He was able to source the hardware including a 
to recognise when the spindle moves. photoresistor and motion-detecting LED froma 


supplier, Riechel, for around €50, and wrote code 
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for the Super 8 Kamera 
project using the custom 
Python program and 

the picamera API. This 
program monitors the 
light detector for changes 
(such as when the user 
presses the camera’s 
record button) and starts recording and streaming 
at the same time. While Bennet’s code is specific 
to the Super 8 video camera, both the project 

idea and the picamera API can be adapted for use 
with other camera and video camera models. See 
magpi.cc/bullseyecamera. 


Fantastic facsimile 

Bennet spent around ten hours designing and 
3D-printing the hardware, assembling the 
electronics, and writing the software. Fitting 
everything together so it fitted within the original 







Super 8 camera chassis involved three design 
versions. “It was quite hard to make the hardware 
fit into the cartridge. The camera placement and 
its cable proved to be an especially challenging 
origami riddle,” he comments. The results, 
however, were more than worthwhile: “It surprised 
me how much the digital footage looks like the 
original Super 8 movies. | did not implement any 
post-processing to make it look more like the 
original film, but still it looks remarkably similar. 
This gives the movies generated by my system a lot 
of character and a certain patina.” Hl 
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A Bennet has also 
successfully 
retrofitted an SLR 
film camera using 
Raspberry Pi Zero W 
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Set up your Raspberry Pi computer with Raspberry 
P| OS, the latest version of the operating system and 
discover all the new features. By Phil King 


hichever model of Raspberry Pi you have, it is part of the 
most creative computer family on Earth. With a Raspberry Pi, 
you can hack, make, and build all kinds of different things. It 
could be a digital camera, a retro games console, or a home media centre. 
You could even control a sensor on board the International Space Station 
if you submit an entry for the Astro Pi missions (astro-pi.org). 
In this guide, we show you how to get started with Raspberry Pi 
using the new Debian ‘Bullseye’ edition of Raspberry Pi OS, as well as 
connecting and controlling some basic electronics. 
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USING RASPBERRY PI 
OS (BULLSEYE) 


Explore the latest version of the default operating system 





o make a Raspberry Pi work, you’!l need 
T to install an operating system. Unless 

your Raspberry Pi came with one already 
preloaded onto a microSD card, you’ |l have to 
ine ies Or Meee ral: 

While other operating systems are available for 
Raspberry Pi (check out our feature in The MagPi 
#111, magpi.cc/111), the official one is Raspberry 
Pi OS, which has recently been updated to the 
‘Bullseye’ version of Debian Linux. 

It’s easy to install 
Raspberry Pi OS onto a 
microSD card using the 
Raspberry Pi Imager tool 
— download it on another 
computer (Windows, 
Mac, or Linux) from magpi.cc/imager. See the 
‘Installing Raspberry Pi OS’ box for details. 

Upon inserting the microSD card with the OS 
on it into your Raspberry Pi’s slot and powering 
up, it will first expand the file system before 
booting to the Raspberry Pi OS desktop. The 
Welcome to Raspberry Pi wizard will take you 
through configuration options including language 
and time zone, prompt you to change the default 
password, ask whether all of the taskbar fits on 
the screen, and prompt you to connect to your 
wireless router by entering its password. 

You’ ll also be asked if you want to check for and 
install any software updates, which you can do 
or skip for now. With setup complete, you’ll be 
prompted to hit Restart to reboot your Raspberry 
Pi. This time it’1l boot straight to the desktop, 
without the wizard, and be ready to use. 


Explore the desktop 
Like most operating systems, the standard version 
of Raspberry Pi OS comes with a desktop interface 
that you can navigate with a connected mouse. 
The default web browser in Raspberry Pi OS is 
Chromium, although you can install others such 
as Firefox ESR, Midori, Vivaldi, and Puffin. 
Chromium is the basis for Google Chrome, so 
you may well find its user interface very familiar. 
There’s an Omnibox where you can enter web 
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M You'll need to install an 
operating system @ 


addresses or search terms. The default search 
engine is DuckDuckGo, which is focused on 
preserving the privacy of searchers, but can be 
changed in the Settings (after clicking on the 
three dots icon in the top right). 

One drawback is that you can’t sync your Google 
account in Chromium to use the same bookmarks 
and settings that you have in Chrome; Firefox 
is an alternative browser that enables cross- 
platform syncing. Other than that, most features 
are present, including the 
ability to add extensions 
from the Chrome Web 
Store and also to group 
tabs together. You can 
also install web apps for 
some sites such as YouTube, by clicking the option 
that appears on the right side of the Omnibox. 


Install extra software 

The standard Raspberry Pi OS only comes with 
a handful of core applications pre-installed 

— although there is a‘Full’ version of the OS 
supplied with a lot more software (find it in 
Raspberry Pi Imager, under ‘Raspberry Pi 

OS (other)’). 

It’s simple to install any extra software you 
want, however. By far the easiest way is to use the 
Recommended Software tool (Menu > Preferences 
> Recommended Software). You can then browse 
a range of applications; to install one, simply tick 
its box and click Apply. 

Applications in Recommended Software 
include the Claws email client and the LibreOffice 
productivity suite. The latter features six 
applications: the Writer word processor, Calc 
spreadsheet, Impress presentation, Draw 
diagrams, Base database, and Math formula editor. 
It can load/save Microsoft Office documents too. 

If you can’t find what you need in 
Recommended Software, you will be able to install 
additional software packages using the Add/ 
Remove Software tool, or by entering commands 
(such as sudo apt install and sudo pip install) 
ina Terminal window. 
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System tray: At the top right of 
the taskbar, you'll see icons for 
Bluetooth, network (wireless 
or Ethernet), and audio, along 
W714 ars moi Kole! em ad(e lal mreiicel dale] 
audio will enable you to 
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- by default it's via HDMI 


Applications menu: 
Click the Raspberry 

mam exe) amxeme) e\-\a ln tal=) 
applications menu. This 
sme lhVile(=toMlalkemal-lleyaelt 
categories such as 
macoye|e=lanlanliave pm ialx=aa(=im 
and Sound & Vision - 
click on one to see its 
contents, then click 
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you to explore Raspberry 

Pi's file system. Like other 
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Taskbar: Shown at the top of the 
screen by default, the taskbar shows 
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clicking an empty part of the taskbar 
brings up the Panel Preferences 
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Terminal: Opening a Terminal 
window enables you to enter 
Maley @exe)aalaat-lale cw Colum aat<\malzi-10. 
to do this occasionally to install 
certain software packages 
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Bom assir- lim atcls)0)01-)d ava mm O sme) mel ele |e-(e(-macelan and insert your microSD card (using a USB 

an earlier version of Raspberry Pi OS to the reYo te] eo) all m al=-1e (10) mm Ol (ei. @m ©) alole\\- a Osi lale| 

latest ‘Bullseye’ edition), you will need to install select ‘Raspberry Pi OS (32-bit). 

a fresh version of the OS to your microSD Now click ‘Choose Storage’ and select Raspberry Pi 
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RINT WORLDWIDE MAG! 


Read digital PDFs of your 
favourite magazines by 
downloading issues in 
the Bookshelf app 


Find out what's changed in the new version of Raspberry Pi OS 


magpi.cc 


ith the basics of the desktop GUI and 

core applications covered, let’s take 

a look at some of the new features in 
Raspberry Pi OS Bullseye and the differences 
from previous versions. 


Get Raspberry Pi OS Bullseye by installing a fresh 
installation of the latest version of Raspberry Pi 
OS from Raspberry Pi Imager (magpi.cc/imager). 


You can’t upgrade from Debian Buster to Debian 
Bullseye using sudo apt full-upgrade — this only 
takes you to the latest version of the current (i.e. 
‘Buster’) operating system. You have to install 
Bullseye onto a fresh microSD card. If you have 
data on your Buster installation you want to Keep, 
we recommend copying it to a separate drive and 
then back to the fresh Bullseye installation. 


Buster is now known as Raspberry Pi OS (Legacy) 
and is available from Raspberry Pi’s Software 


Get Started With Raspberry Pi 


page (magpi.cc/buster). It can also be found in 
Raspberry Pi Imager. Read more about Raspberry 
Pi OS (Legacy) in Gordon Hollingworth’s blog post 
(magpi.cc/legacy). 


If you’ve used Raspberry Pi OS before, you’ ll 
immediately notice that the default wallpaper is 
different in Bullseye. If you like, you can change it 
in Preferences > Appearance Settings. 

Another change you may notice is that desktop 
windows have a shadow effect on their borders, 
and animate as they open and close. Widgets and 
their tabs and buttons also look a little different. 

In File Manager, the view modes have been 
simplified, with icon options to switch between 
icons or list mode. For more advanced options, 
you can use the View menu to zoom the icon size 
in/out and select thumbnail icon mode. 


One of the numerous under-the-hood changes 
in Raspberry Pi OS Bullseye is that the KMS 
(kernel mode setting) video driver is now 


used by default, whereas previously it was an 
experimental option. 

While you may not notice much of a change 
in how the video display works or performs in 
general, one major advantage of using KMS is 
that it’s the standard open-source video driver 
used in Linux. This means that any application 
written using the standard Linux display APIs 
should run on Raspberry Pi without the need 
for modification. 

In addition, now that all the display drivers for 
Raspberry Pi OS are part of the Linux kernel, this 
should make it easier for manufacturers of custom 
displays to add support for Raspberry Pi. 

The upgrade to Bullseye brings with it an update 
of Chromium to version 92, which has also been 
optimised to use Raspberry Pi’s hardware to 
accelerate video playback. 


M Bullseye takes Its 
name from a character 
In Disney's Toy Story 
movie franchise @ 


Anything else new? 

The Bookshelf application now includes free 
downloadable PDFs of our sister publication 
Custom PC, the Uk’s best-selling magazine for PC 
hardware, overclocking, gaming, and modding. 
Bookshelf also contains issues of The MagPi, 
HackSpace, and Wireframe magazines, along with 
our Official Raspberry Pi books. 


Will my Raspberry Pi run faster? 

There’s a speed boost bonus for owners of recent 
Raspberry Pi 4 and Raspberry Pi 400 models: the 
default turbo-mode clock has increased from 
1.5GHz‘to 1.8GHz. For more details, see Eben 
Upton’s blog post: magpi.cc/bullseyeboost. You 
can manually overclock many models of Raspberry 
Pi (magpi.cc/overclock). 


Why doesn’t my Raspberry Pi have the 

new interface? 

The new look is down to the use of a new window 
manager called Mutter (magpi.cc/mutter). The 
switch to Mutter is due to the upgrade from GTK+2 
to GTK+3 for user interface components. Mutter 
replaces the Openbox window manager used 

in previous versions of the OS. Openbox is still 
employed if your Raspberry Pi model has less than 
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2GB of RAM, because Mutter is quite demanding 
in terms of memory usage. 


How do | manage notifications? 

Raspberry Pi OS Bullseye now has a common 
notification manager which tells you about things 
like USB devices being inserted/removed and low 
power supply voltage, and memory allocation. 

Notifications appear in grey windows under 
the right end of the taskbar, with the most recent 
messages shown at the top. Each notification 
will time out and automatically disappear after 15 
seconds, or when you click on it. 

The notification timeout setting can be altered 
in the Appearance tab of the Panel Preferences 
dialog, accessed by right-clicking the taskbar. 

If you set the timeout to zero, notifications will 
stay on screen until clicked. You can also turn 
notifications off completely (not advisable). 


How should | keep Bullseye up-to-date? 
Another major user-friendliness improvement in 
Bullseye is the introduction of an updater plug-in 
for the taskbar. Whenever you reboot Raspberry 
Pi, or every 24 hours if it’s left powered up, it 

will check for any software updates and show 

an update icon in the taskbar with a notification 
telling you that updates are available. 

Click the update notification to open a window 
showing you the packages that can be updated. 
Just click the Install button to start installing 
them; you can then carry on with whatever you 
were doing while they install in the background. 


Why is it ‘Bullseye’? 

Every major version of the Debian Linux distro, 
upon which Raspberry Pi OS is based, takes its 
name from a character in Disney’s Toy Story movie 
franchise. Previous versions include Wheezy, 
Jessie, Stretch, and Buster. If you’ve not seen the 
movies, Bullseye is Woody and Jessie’s horse, one 
of the new characters introduced in Toy Story 2. 


Get Started With Raspberry Pi | magpi.cc | 35 


MagPi 


Get to grips with using Raspberry P! cameras with Bullseye! By David Plowman 


hen we released our first Raspberry Pi 

OS image based on Debian Bullseye, 

we pointed to a change that is hugely 
important to people who have written code to 
use cameras with Raspberry Pi: the driver that 
Raspberry Pi uses to access Camera Modules has 
been replaced with libcamera. 

These very significant changes mean less 
closed-source code, and they make it easier for 
people outside of Raspberry Pi to develop new 
camera hardware and software; but they also 
mean that new Raspberry Pi OS releases will no 
longer support the familiar raspicam apps and 
picamera Python library. 

In the place of this older camera system is the 
new and almost entirely open-source camera 
stack based on standard Linux frameworks such 
as V4L2 (Video for Linux) and libcamera. Our 
kernel drivers have been moving in this direction 
for some time too, and have just recently taken 
further large strides towards the preferred new 
Media Controller architecture. 


Mi] oer=laal=1e= tral ©) Os-lk>me(=11[e]al=16 mK Meco) ©)\Vmaaloy=] me) maato mab laleis(olal=lliAVmnal| mols 16s 
will know from raspistill, raspivid, and raspiyuv. There are some unavoidable 
ollins)a=ialecrsMmyAallera ma lcom=>cclaaliacre lame |g=y-1k=) me (=1-l|Me)al tots) 0)0\-) aaa BS 
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libcamera-hello - a simple ‘hello world’ application that starts a 


camera preview stream and displays it on the screen. 
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then capture high-resolution still images. 
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emulates more of the features of raspistill. 
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Bayer) frames directly from the sensor. 
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can build it if they have TensorFlow Lite installed on their Raspberry Pi. It 


captures JPEG images when certain objects are detected. 
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But the principal difference that users will 
notice is that OS releases from Bullseye onwards 
will no longer support the older camera system 
and applications, and Raspberry Pi’s libcamera- 
apps will be built and pre-installed instead. 
Before we go further, note that Raspberry 
Pi OS Buster is still available to download if 
you’re not ready to use Bullseye. If you are 
using camera applications with your Raspberry 
Pi, we recommend you take some time to 
weigh up whether to move to Bullseye at this 
point. A blog post on the Raspberry Pi website 
(magpi.cc/bullseyecamera) considers why, and 
why not, you might want to do so. 


Aversion of Raspberry 

Pi OS based on the 

older ‘Buster’ system is 
re\Wrelltole]Kommnccye(emelelele lms 
on this Raspberry Pi post. 
magpi.cc/legacy 
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Raspberry Pi OS (Bullseye). It replaces the “Enable/ 
disable connection to the Raspberry Pi Camera” 
found in Raspberry Pi OS (Buster) and previous 
Raspberry Pi operating systems. (You no longer 
lal=xove Kom Kon-Jal-lo)l-mer-laal=1e- B00) ole)am lalatcs)el-14aV) 
Pi OS (Bullseye) as the libcamera API is enabled 
by default). 

Legacy Camera Support is included in the 
Rel KoX\ mo | ofe f= 1k MKOM atl] 0) 0\-1 4 AVM Os @) 0l- lam MK-laaallarell 
Wilate(e)w/melale ala koe 


sudo apt-update 
sudo apt full-upgrade 


You will need to reboot Raspberry Pi OS for the 
changes to take effect (Menu > Shutdown and 
click Reboot). 

Use raspi-config to enable Legacy Camera 
Mode. In a terminal window enter: 


sudo raspi-config 


Chose ‘3 Interface Options’ and ‘Il1 Legacy Camera’ 
and select ‘Yes’ in the ‘Would you like to enable 
legacy camera support?’ window. You will see a 
laal=sssste\e (> mst= \lale im aie [= (@aVmere la a(=)¢>Bs16| 0) ele) am ice-larcle) (ciel 
along with ‘Please note that this functionality is 
fo(=Je)q-1er-| K-10 = 1a(e MW //1| male)mol=u0|e) ole) an-eme)mablnelas 
fo(=\V{=) ke) o)aal= Jal mm mie [= (enV Oe laal=1e-Mulere(MUAIIm=latcle)KmVZel6| 
to use Picamera-based projects with Raspberry Pi 
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See the Raspberry Pi Documentation for 
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Ent lesdisaale remote command Line access using SSH 
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Ens ledisaile automatic loading of SPE kernel sodale 
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Th Remote FO Ent letdisah le remote access fo GPIG pass 


Enable Legacy Camera Mode in raspi-config 
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CONNECTING ELECTRONICS 





Make use of Raspberry Pi's GPIO header to connect and control circuits. By Phil King 


hile Raspberry Pi can be used as an 
W effective desktop PC, a major bonus 

is that it can easily be connected to 
electronic circuits and add-on boards (often 
called HATs) via its 40-pin GPIO header. This is 
found on every Raspberry Pi model, including the 
tiny Zero 2 W and also the Pi 400. See the GPIO 
diagram below for details of pin functions. 

There’s a wide variety of HATs (Hardware 

Attached on Top) and other expansion boards 
available for Raspberry Pi. On most Raspberry Pi 
models, the HAT just fits on top of the GPIO pins 
and is positioned over the computer’s PCB. Since 
Raspberry Pi 400’s GPIO header is located at the 
rear of the keyboard unit and is slightly inset, 
however, you may well need a ribbon cable or 
breakout adapter to connect a HAT. 


e 











3V3 power o 5V power 
GPIO 2 (SDA) o 5Vpower 
GPIO 3 (SCL) o—— Ground 
GPIO 4 (GPCLKQ) « > GPIO 14 (TXD) 
Ground > GPIO 15 (RXD) 
GPIO 17 « GPIO 18 (PCM_CLK) 
GPIO 27 © Ground 
GPIO 22 o GPIO 23 
3V3 power GPIO 24 
GPIO 10 (MOSI) « Ground 
GPIO 9 (MISO) « GPIO 25 
GPIO 11 (SCLK) « GPIO 8 (CEO) 
Ground « GPIO 7 (CE1) 
GPIO 0 (ID_SD) GPIO 1 (ID_SC) 
GPIO 5 « > Ground 
GPIO 6 « GPIO 12 (PWMO) 
GPIO 13 (PWM1) « Ground 
GPIO 19 (PCM_FS) « 0 GPIO 16 
GPIO 26 o GPIO 20 (PCM_DIN) 
Ground « GPIO 21 (PCM_DOUT) 


> Apart from power (3V3 and e 


5V) and ground (GND) pins, 
most GPIO pins can act as 
an input or output; some 
have special secondary 
functionality such as PWM, 
2G or SP 
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Alternatively, connect and control your own 
electronic circuits to the GPIO pins using jumper 
wires. Standard electronic components such as 
LEDs, push-buttons, and sensors can be used, 
often via a breadboard (magpi.cc/breadboard). 


JAM HAT 

For this introductory electronics example we’ ll 
make things simpler by using a JAM HAT. 
Available from The Pi Hut (magpi.cc/jamhat), 
this add-on board features built-in LEDs, push- 
buttons, and a piezo buzzer. Just slot it onto your 
Raspberry Pi’s GPIO header (or connect to Pi 400 
via aribbon cable or breakout adapter). 


M Set up the LEDs as 
traffic lights and use 
q push-button for a 
pedestrian crossing @ 


You are now ready to start programming your 
first electronics project in the popular Python 
language. In Raspberry Pi OS, open the Thonny 
IDE (Menu > Programming > Thonny IDE). The 
easiest way to read and control the GPIO pins in 
Python is to use the GPIO¥ero library. This even 
has a special class for the JAM HAT - at the start 
of our code, we import this with: from gpiozero 
import JamHat. 

So that we can incorporate a delay in our 
program, we also import the sleep method from 
the time library: from time import sleep. 

We then assign a variable, jamhat, to the JamHat 
class, with: jamhat = JamHat(). 

Now, to blink the two rows (lights_1 and 
lights _2) of LEDs in turn, we can use GPIO Zero’s 
blink method: 


jamhat.lights_1.blink() 
sleep(@.5) 
jamhat.lights_2.blink() 


See the jam-LEDs. py listing for the full code. 
Run it in Thonny to see the effect. We can specify 
which colour LED in each row to blink. To turn on 
the red LED in row 1 for one second enter: 











jamhat.lights_1.red.on() 
sleep(1) 
jamhat. lights 1.red.off() 












Push the button 
We can also read the input (on or off) from 
the JAM HAT’s push-buttons. We will use the 

when_pressed method to check when the button 

has been pressed. We will also need to tell the 

program what to do when it is pressed, in this > 
case turning on all the JAM HAT’s LEDs and its 

buzzer using the jamhat.on command: 


jamhat.button_1.when_pressed() = jamhat.on() J 6) m- LE D S: py 


See the jam-button.py listing for the full code. > Language: Python 3 
Run it and every time you press button 1, the LEDs 
will light up and the buzzer will make a noise. 
Press button 2 to turn them off. 

There’s a lot you can do with the JAM HAT, 
including setting up the LEDs as traffic lights and 
using a push-button for a pedestrian crossing. 

For more details, see the JAM HAT getting-started 
cuide (magpi.cc/jamhatguide) and further code 
on GitHub (magpi.cc/jamhatgit). 


001. from gpiozero import JamHat 
Q@2. from time import sleep 


G04. jamhat = JamHat() 


Q06. jamhat.lights 1.blink() 
Q@07. sleep(@.5) 
G08. jamhat.lights 2.blink() 


WV Making electronics easier, the 
JAM HAT features six coloured 
LEDs, two tactile push-buttons, at 


and a buzzer — " Fe ) 





jam-buttons.py 





> Language: Python 3 


Q0@1. from gpiozero import JamHat 
002. 
Q03. jamhat = JamHat() 


004. 

Q0@5. jamhat.button_1.when_pressed = 
jamhat.on 

Q06. jamhat.button_2.when_pressed = 
jamhat. off 
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Richard Hayler 


Richard Is an 
engineer who's 
easily distracted 
by comics, music, 
rugby, and LEGO. 
His quest to 
combine them 
into a single 
activity is ongoing. 
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Marc Scott 


Marc Is a former 
computer science 
teacher, and 
manages informal 
learning content 
for the Raspberry 
Pi Foundation. 
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Here is our early 
one-player Pong 
game, with a white 
ballin the centre of a 
black window, with a 
single green paddle 
on the far left 





Make a Build HAT 


game controller 


Build ag Pong paddle-style controller using Build HAT and bricks 


Pi Build HAT, a LEGO® Technic™ motor 

encoder and wheel, and the Python Turtle 
library to make a simple game controller that 
you can use to play Pong. 

Pong is one of the earliest arcade video games, 
originally released in 1972 by Atari. It is a table 
tennis game featuring simple two-dimensional 
eraphics. Players control paddles on each side 
of the screen, which they use to hit a ball back 
and forth. 

You will learn how to read the degrees of 
rotation from LEGO Technic motors, how to draw 
and move Turtle graphics using LEGO Technic 
motors, and how to detect collisions between 
eraphics using x and y coordinates. 


n this project, you will use the Raspberry 


Set up Build HAT 


Before you begin, you’ll need to have set up 
your Raspberry Pi computer and attached a Build 
HAT. If you have a Maker Plate™, mount your 
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Raspberry Pi to it using M2 bolts and nuts, making 
sure your Raspberry Pi is mounted on the side 
without the ‘edge’. 

Mounting Raspberry Pi this way round enables 
easy access to the ports as well as the SD card 
Slot. The Maker Plate will allow you to connect 
Raspberry Pi to the main structure of your 
dashboard more easily (this is an optional extra). 

Line up the Build HAT with your Raspberry Pi, 
ensuring you can see the ‘This way up’ label. Make 
sure all the GPIO pins are covered by the HAT, and 
press down firmly. 

You should now power your Raspberry Pi using 
the 7.5V barrel jack on the Build HAT, which will 
allow you to use the motors. 

You will also need to install the buildhat 
Python library. Open a Terminal window on your 
Raspberry Pi and enter: 


sudo pip3 install buildhat 


Press ENTER and wait for the ‘installation 
completed’ message. 


Motor encoders 
Motor encoders can not only rotate: they 
can also accurately detect how many degrees they 
have been rotated. 

The LEGO Spike™ motors all have encoders. 
If you look at the rotating disc part of the motor, 
you will see a mark shaped like a lollipop that 
can be lined up with the 0 mark on the white 
body of the motor itself. This is the encoder set 
to zero degrees, and any angular movement 
of the motor shaft can be measured relative to 
this point. 

A motor encoder, also called a rotary or shaft 
encoder, is an electromechanical device that 
allows you to record the angular position or 








‘ i | 
ies fs 


S]UTI CoM a PNM =Jat-1o)(=\-mYcelem Komere) alice) | 
LEGO components with Raspberry 
Pi. Here, a motor is connected to 
foXeyamwWelamial-m =10l|KeMm/-Wir-lalem-mt-lge(=) 
wheel is attached to the motor 


. ae Bee | 





SD isa: | 








: = Bi at=maalelve) mere) air-lial-e-lam-larecele(-m-val-lelliaremis 
1 Ko Me (=) <= 1e4 Ml | MoM ge) t= 1 8(0) at-|m oles) 4(0) a Mm Malla) cm Ke) 
idalicWalomor- la aale)Vi-m val-maalelke) ml o)Vmar-lale r= lale. 
UIToM id al=m=) rexel (=) ne me(=1x-1e1 ma aiom oley-yid(e) ah 
10 gallavemaat=mudal=1-1 Gl alee- Mme) are pe-i avi (=m ey-le(e|K=) 


ye 





motion of the axle. It normally does this by 
converting the angular position to an analogue or 
digital output. 

If a motor has an encoder, that means you can 
very accurately set the position of the axle. It also 
allows you to use the motor as an input device so 
that if something changes the position of the axle, 
this can be registered and used to trigger other 
actions in a computer program. 

Open Thonny from the Programming menu, 
click on the Shell area at the bottom, and enter: 


from buildhat import Motor 
motor_left = Motor('A') 


Depending on how well you positioned the motor 
at the start, you should get a value close to ‘o’. 
Move the motor and type the second line again, 
and see how the value changes. 


React to motor 

encoder movement 
To use the LEGO Technic™ motors as a controller 
for a game, you’ll need to be able to constantly read 
their absolute positions. 

In the main Thonny window above the Shell, you 

can use the commands you already know to find 
the absolute position of the motor. Then, in a while 
True: loop, you can print the value of the position. 


Enter this code, save the file, and press Run. 


from buildhat import Motor 
motor_left = Motor('A') 


while True: 
print(motor_left.get_aposition() ) 


You should see that your program continually 
prints the position of the motor. If you rotate the 
motor, these values should change. 

There is a better way of doing this, though. You 
only need to read the motor position if it is moved. 
Delete the while True: loop from your program 

and create this simple function that prints the 
absolute position of the motor. You will also need to 


add another import line to use the pause() function. 


from buildhat import Motor 
from signal import pause 
motor_left = Motor('A’) 


def moved _left(motor_speed, motor_pos, 
motor_apos): 
print(motor_apos) 


Now set this function to run when the motor's 
encoder is moved: 


from buildhat import Motor 
from signal import pause 





You'll Need 


> Raspberry Pi 
computer 


>» Raspberry Pi 
Build HAT 
magpi.cc/buildhat 


>» Assortment of 
LEGO, including 
wheels (we used a 
selection from the 
LEGO Education 
SPIKE Prime kit) 
magpi.cc/spikeprime 


> Small breadboard, 
buzzer, and jumper 
leads (optional) 


>» 5V power supply 
with a barrel jack 
(optional) 
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TopTip @ 


Get started 


See The MagPi 
issue 112 for 

a quick guide 
to setting up 
Build HAT. 
magpi.cc/112 





> Figure1The 
co-ordinates for the 
game area In our 
version of Pong 


motor_left = Motor('A') 


def moved _left(motor_speed, motor_pos, 
motor_apos): 
print(motor_apos) 


motor_left.when_rotated = moved_left 
pause() 


Run your code and you should see the values printed 
out in the Shell change when the motor is moved. 


Make your Pong screen 

Open a new file in Thonny and add the 
following code to import the Turtle, time, and Build 
HAT libraries, and then set up a screen. Run the file 
and you should see a black window with the title 
‘PONG’ open. 





from turtle import Screen, Turtle 
from time import sleep 
from buildhat import Motor 


game_area = Screen() #Create a screen 

game_area.title("PONG") #Give the screen a 
title 

game_area.bgcolor('black') #Set the 
background colour 

game_area.tracer(0) #Give smoother 
animations 


The Turtle library also has a useful way of setting 
the co-ordinates for a screen area. Add this line to 
your program: 


-200, 170 200, 170 





-200, -170 


200, -1/0 
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game_area.tracer(@) 
game_area.setworldcoordinates(-200, -170, 
200, 170) 


This creates a rectangular window 400 pixels 
wide and 340 high, with o being in the centre (see 
Figure 1). 

Now, you need to update your game area, to see 
the paddle and ball. Add a game loop to the bottom 
of your code, and call the update() method. 





while True: 
game_area.update() 


Run your code and you should see a black window 
appear. Next, you can make a ball by using a Turtle 
that is set to be a white circle. The ball should start 
in the middle of the screen, and shouldn’t draw a 
line when it moves. Above your while True: loop, 
add the following code: 


ball = Turtle() 
ball.color('white' ) 
ball.shape('circle' ) 
ball. penup() 
ball.setpos(0,@) 


while True: 


Run your code again. You should see a white ball 
appear in your window. Next, you can set upa 
paddle in the same way. It will be a green rectangle, 
and positioned on the far left of the screen. 


paddle left = Turtle() 

paddle _left.color('green' ) 
paddle _left.shape('square' ) 
paddle left.shapesize(4, 1, 1) 
paddle_left.penup() 

paddle _left.setpos(-190, @) 


Run your code and you should see your ball 
and paddle. 


Move the ball 

The ball is going to bounce around the 
screen, So two variables are needed to keep track of 
its speed in both the ‘x’ and ‘y’ directions. These 
numbers can be larger to make the game harder, or 
smaller to make the game easier. 








ball.speed_x = 1 


ball.speed_y = 1 


You can check where a Turtle is by using 
turtle.xcor() and turtle.ycor() to find the ‘x’ 
and ‘y’ co-ordinates, respectively. So to make 
the ball move, you can combine the position and 
speed. Add the lines below to your program: 


while True: 
game_area.update() 
ball.setx(ball.xcor() + ball.speed_ x) 
ball.sety(ball.ycor() + ball.speed_y) 


Run the program and see what happens! The 

ball should move diagonally upwards towards 

the top right corner of the game area... and 

then keep on going! If you want your game to 

be fast and challenging, you can increase the 
speed x and speed_y values to make the ball move 
more quickly. 

The ball should bounce off the top wall rather 
than disappear off the screen. To do this, the 
speed can be reversed, making the ball travel in 
the opposite direction, if its ‘y’ position is greater 
than 160. 

Add the following code into your game loop and 
Tui it, 


while True: 
game_area.update() 
ball.setx(ball.xcor() + ball.speed_x) 
ball.sety(ball.ycor() + ball.speed_y) 
if ball.ycor() > 160: 
ball.speed_y *= -1 


Run your code again, and the ball should bounce off 
the top of the screen, but disappear off the right of 
the screen. 

In the same way that the code checks the upper 
‘y’ position of the ball, to make it bounce, it can 
check the right ‘x’ position and the lower ‘y’ 
position, in your game loop. 

Add these checks on the ball’s position. 


if ball.ycor() > 160: 
ball.speed_y *= -1 

if ball. xcor() > 195: 
ball.speed_x *= -1 

if ball.ycor() < -160: 
ball.speed_y *= -1 


The ball should now bounce around the screen, 
and fly off the left edge. Next, you will control your 
paddle to reflect the ball back from the left edge. 
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A. Connect a motor 
to port A on the 
Build HAT 


Control the paddle 


The LEGO Spike motor is going to be used 
to control the position of the paddle, but you don’t 
want to be able to make full turns. 

A simple way to limit the motion of the wheel 
is to add a LEGO element to prevent the wheel 
turning through a complete rotation. 

Line up the encoder marks on your motor using 
the wheel, like before. Insert a peg or axle as close 
to level with the markers as possible. 





™ The LEGO Spike motor is going to be used 
to control the position of the paddle & 


Add a line to create the motor_left object after 
the import line. 


from buildhat import Motor 

motor_left = Motor('A') 
Now a new variable is needed to keep track of the 
location of the paddle. This will be called pos_left 


and set to oO. 


Q.4 
ball.speed_y = 0.4 


ball.speed_x 


pos left = @ 


Create a function for the paddle that will run 
when the motor encoder moves. Note that it uses 
a global variable so that it can change the value of 
the pos_left variable. 
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A Use pegs to 
attach the wheel 
to the motor 


def moved _left(motor_speed, motor_rpos, 
motor_apos): 
global pos _ left 
pos_left = motor_apos 


Now add a single line that will use that function 
each time the motor is moved. It can be just before 
your while True: loop. 


motor_left.when_rotated = moved_left 


Then, add a line to the while True: loop to update 
the paddle object on the screen to the new position. 


if ball.ycor() < -160: 
ball.speed_y *= -1 
paddle left.sety(pos_ left) 


Run your code and then turn the wheel on your 
motor encoder. You should see your paddle moving 
up and down the screen. 

In case there are errors, your code should 
currently look like pong.py. 


ny, Paddle collisions 

The game is nearly complete — but first you 
need to add some extra collision detection that 
covers the ball hitting the paddle. 

Within the while True: loop, check if the ball’s 
‘x’ position is within the horizontal area covered 
by the paddle. Also use an and to check the ball’s 
‘y’ position is in the vertical line in which the 
paddle moves. 


paddle _left.sety(pos_ left) 

if (ball.xcor() < -18@ and ball.xcor() > 
-190) and (ball.ycor() < paddle _left.ycor() 
+ 20 and ball.ycor() > paddle left.ycor() - 


44 | magpicc | Makea Build HAT game controller 


20): 
ball.setx(-180) 
ball.speed_x *= -1 


Try the program out. You should be able to bounce 
the ball off your paddle and play a solo game 
of ‘squash’! 

Now you have a way of preventing the ball from 
disappearing off-screen, it’s time to think about 
what happens if you fail to make a save. For now, 
let’s just reset the ball back to the start. 

Add this code within the while True: loop: 


ball.speed_x *= -1 
if ball.xcor() < -195: #Left 
ball.hideturtle() 
ball. goto(@,0) 
ball. showturtle() 


Once you’re happy with the various settings, it’s 
time to add in the second paddle. Using what 
you ’ve created for the left-hand paddle as a 
Starting point, add a second paddle on the right- 
hand side of the game area. 


M Once you're happy 
with the various 
settings, it's time to add 
in the second paddle 


First of all, connect a second LEGO Technic 
motor to the Build HAT (port B) and set it up in 
the program. 


motor_left = Motor('A') 
motor_right = Motor('B') 


You can copy and paste your code for setting up 
your left paddle, and change the name and values 
for your right paddle. Create your right paddle. 


paddle left = Turtle() 
paddle _left.color('green’' ) 
paddle left.shape("square") 
paddle left.shapesize(4,1,1) 
paddle _ left.penup() 

paddle _left.setpos(-190,0) 


paddle right = Turtle() 
paddle right.color('blue' ) 
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paddle right.shape("square" ) 
: , DOWNLOAD 

paddle right.shapesize(4,1,1) F : 

paddle _ right.penup() pong py THE FULL CODE: 


paddle right.setpos(190,@) . 
> Language: Python 3 y) magpi.cc/pongpy 


Add a variable for the right paddle position, a 












function for the paddle, and the line to call the Q@1. from turtle import * 
function when the right motor is moved. Q@2. from time import sleep 
Q03. from buildhat import Motor 
pos left = @ 004. 
pos right = @ Q@05. motor_left = Motor(‘A') 
006. 
def moved_left(motor_speed, motor_rpos, Q@07. game_area = Screen() 
motor_apos): Q08. game_area.titlev’ PONG’ ) 
global pos left Q@09. game_area.bgcolor('black') 
pos left = motor_apos Q10. game_area.tracer(@) 
Q@11. game_area.setworldcoordinates(-200, -170, 200,170) 
def moved right(motor_speed, motor_rpos, 012. 
motor_apos): Q@13. ball = Turtle() 
global pos_right Q@14. ball.color('white' ) 
pos right = motor_apos Q@15. ball.shape('circle’') 
Q16. ball.penup() 
motor_left.when_rotated = moved_left Q@17. ball.setpos(@,@) 
motor_right.when_rotated = moved_right 018. 
Q19. paddle left = Turtle() 
Add a line to update the paddle on screen to the Q@20. paddle left.color('green') 
while True: loop: Q@21. paddle left.shape("square") 
Q@22. paddle left.shapesize(4,1,1) 
paddle _left.sety(pos left) Q@23. paddle left.penup() 
paddle right.sety(pos_ right) Q@24. paddle left.setpos(-190,0) 
Q25. 
Currently, the ball will bounce off the right-hand Q@26. ball.speed x = 0.4 
wall. Modify the lines of your program that make Q@27. ball.speed_y = 0.4 
that happen so that the ball is instead reset to the Q28. 
centre. Now add a similar condition for the right Q@29. pos left = @ 
paddle as you did with the left, to handle collisions. Q30. 
Q@31. def moved _left(motor_speed, motor_rpos, motor_apos): 
POMS aa Q32. global pos_left 
0 PONG @ Q33. pos left = motor_apos 
034. 
Q@35. motor _left.when_rotated = moved left 
036. 
Q@37. while True: 
Q38. game_area.update() 
Q39. ball.setx(ball.xcor() + ball.speed_ x) 
240. ball.sety(ball.ycor() + ball.speed_y) 
Q41. if ball.ycor() > 160: 
Q42. ball.speed_y *= -1 
043. if ball.xcor() > 195: 
Q44. ball.speed_x *= -1 
Q45. if ball.ycor() < -160: 
Q46. ball.speed_y *= -1 
Q47. paddle left.sety(pos_left) 





A Aview of the game window with the score displayed at the top 
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TopTip @& 


Turtle Race 


Turtle is a drawing 
and animation 
library and you 
can learn more 
about it with the 
excellent Turtle 
Race projects. 
magpi.cc/ 
turtlerace 





WV The rotating disc 
of the motor has a 
mark shaped like a 
lollipop, this can be 
lined up with the o 
mark on the white 
body of the motor. 
This is the encoder 
set to zero degrees 





at 
a 
_———!~ | 


if (ball.xcor() < -18@ and ball.xcor() 
> -190) and (ball.ycor() < paddle _ left.ycor() 
+ 20 and ball.ycor() > paddle left.ycor() - 
20); 
ball.setx(-180) 
ball.speed_x *= -1 
if (ball.xcor() > 180 and ball.xcor() < 
190) and (ball.ycor() < paddle _right.ycor() 
+ 20 and ball.ycor() > paddle right.ycor() - 
20): 
ball.setx(18@) 
ball.speed_x *= -1 


You should now be able to enjoy a basic two-player 
game of Pong. Your code should currently look like 
two_player_basic.py. 


Improve your project 
There are a few additional features you can 
add to finish off your game. Keep track of the score 
by using two variables (one for each player) and 
update them whenever a round is lost. 
First of all, declare the new variables towards the 
top of the program and set the score to zero. 


ll 
© 


score_r 
score l = @ 


Whenever a ball is missed, increment the 
appropriate score variable by one. There are two 
conditional tests you’ll need to modify. 


if ball.xcor() > 195: #Right 
ball. hideturtle() 
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ball. goto(@,0) 
ball.showturtle() 

score _r+=1 

if ball.xcor() < -195: #Left 

ball. hideturtle() 

ball. goto(@,0) 

ball. showturtle() 

score _l+=1 


Now you need to display the score in the game 
area. You can use a fourth Turtle to do this. Add 
the following to your program after the creation 
of the paddle and ball Turtles, but before the while 
True: loop. 


writer = Turtle() 

writer.hideturtle() 

writer.color('grey' ) 

writer.penup() 

style = ("Courier", 30, bold’) 

writer.setposition(@,15@) 

writer.write(f'{score_1} PONG {score _r}', 
font=style, align="center’ ) 


You can look at the documentation for the Turtle 
library to see what other options there are for how 
the text is displayed. 


™ There are a few additional 
features you can add to 
finish off your game 


If you run your program now, the score and Pong 
legend should appear, but the scores themselves 
won’t get updated. 

Find the two conditionals for each of the scoring 
situations — when the ball is missed by a paddle 
and disappears to the left or right — and update the 
score by rewriting the new value. 


writer.clear() 
writer.write(f'{score_1} PONG 
{score _r}', font=style, align='center' ) 


Adding a buzzer 

To include some simple sound effects, 

connect a buzzer to the GPIO pins on Raspberry Pi. 
Instead of using a breadboard, you could use 

jumper leads with female sockets at both ends 
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two_player_basic.py Pee eae 


© magpi.cc/twoplayerbasicpy 






> Language: Python 3 


ee1. from turtle import * QA2. pos left = motor_apos 

ee2. from time import sleep Q43. 

ee3. from buildhat import Motor e44, def moved_right(motor_speed, motor_rpos, 
ee4. motor_apos): 

ees. motor_left = Motor(‘A') Q@45. global pos right 

ee6. motor_right = Motor('B') Q46. pos right = motor_apos 

007. 047. 

@e8. game_area = Screen() e4g8. motor_left.when_rotated = moved left 

ee9. game_area.title( ‘PONG’ ) e49,. motor_right.when_rotated = moved right 

Q@10. game_area.bgcolor('‘black’') ese. 

Q@11. game_area.tracer(@) Q@51. while True: 

Q@12. game_area.setworldcoordinates(-200, -170,200,170) Q52. game_area.update() 

Q13. Q53. ball.setx(ball.xcor() + ball.speed_x) 
e14. ball = Turtle() Q54. ball.sety(ball.ycor() + ball.speed_y) 
@15. ball.color('white') @55. if ball.ycor() > 160: 

e16. ball.shape('circle' ) 56. ball.speed_y *= -1 

@17. ball.penup() Q57. if ball.xcor() > 195: 

@18,. ball.setpos(@,Q) 58. ball.hideturtle() 

Q19. Q@59. ball.goto(0,@) 

e2@. paddle left = Turtle() Q6e. ball.showturtle() 

@21. paddle left.color('green' ) 061. if ball.ycor() < -160: 

@22. paddle left.shape("square") 062. ball.speed_y *= -1 

Q@23. paddle left.shapesize(4,1,1) 063. paddle _left.sety(pos_left) 

@24. paddle left.penup() 064. paddle right.sety(pos_right) 

@25. paddle left.setpos(-190,0) Q@65. if (ball.xcor() < -18@ and ball.xcor() > 
Q26. -190) and (ball.ycor() < paddle _left.ycor() + 20 
@27. paddle right = Turtle() and ball.ycor() > paddle left.ycor() - 20): 
@28. paddle right.color('blue’) Q66. ball.setx(-180) 

@29,. paddle right.shape("square") Q67. ball.speed x *= -1 

@39@. paddle right.shapesize(4,1,1) 68. if (ball.xcor() > 180 and ball.xcor() < 190) 
Q@31. paddle right.penup() and (ball.ycor() < paddle right.ycor() + 20 and 
@32. paddle right.setpos(190,0) ball.ycor() > paddle_right.ycor() - 20): 
Q33. 69. ball.setx(180) 

@34. ball.speed x = @.4 070. ball.speed x *= -1 

@35. ball.speed_y = 9.4 @71. if ball.xcor() < -195: # left 

Q36. Q@72. ball.hideturtle() 

@37. pos left = @ Q73. ball. goto(@,@) 

Q@38. pos_right = @ Q@74. ball. showturtle() 

039. 


e4e@. def moved left(motor_speed, motor_rpos, 
motor_apos): 
Q41. global pos left 
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> Attachapeg 
to the rear of 
the wheel to 
prevent the wheel 
from spinning 
indefinitely 





and poke the legs of the buzzer into the socket. 
Then use some LEGO elements to mount the 
buzzer so that it doesn’t flop around and become 
disconnected during frantic gaming sessions. 

Now add the gpiozero library to the list of 
imports at the start of your program: 


from gpiozero import Buzzer 


Then, make the buzzer available for the program to 
use, by setting which pin you have connected the 
positive (+) leg to. here, we used GPIO17. 


buzz = Buzzer(17) 


If you didn’t use GPIO17, change the value to 
reflect the pin your buzzer is connected to. 
Now, whenever the paddle and ball make 
contact, you want the game to play a short tone. 
Add this line to each action part of the collision 
detection if conditionals for the ball and paddle: 


buzz.beep(@.1,0.1, background=True) 


Then adda line to play a longer tone whenever the 
player misses the ball. 


buzz.beep(@.5,0.5, background=True) 
You can read more about the options 


available with buzzers in the GPIO Zero 
documentation (magpi.cc/buzzer). 
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™ Add even more randomness 
to the speed and trajectory 
of the ball, and make the 
Dall move faster @ 


Improve the Pong game 

Here are some ideas to improve your game 
of Pong. You can add even more randomness to the 
speed and trajectory of the ball, and make the ball 
move faster as the game progresses. 

Right now the game carries on forever — consider 
having a target score that a player must achieve 
in order to win and then start a new set of rounds; 
change the scoring method to count how many 
times the players return the ball to one another, 
and reset when someone misses. Or, introduce 
some haptic feedback, so that the motors turna 
small amount when a point is lost. 

At the moment it doesn’t matter what part of the 
paddle connects with the ball; it will always bounce 
off at the same angle as it hit. Modify the collision 
code so that the angle becomes more obtuse if the 
ball makes contact close to the end of the paddle. 

Create more games that use the LEGO Technic 
motors as controllers. 

How about a game in the style of Angry Birds, 
where two controllers are used to set the launch 
trajectory and the amount of force applied to 
the catapult? Wi 
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Explore the 
sensory world: 
Build a simple 
weather station 











Phil King Measure temperature, humidity, and UV light with this basic weather station 
Long-time 
contributor to The 
MagPi, Philis a reviously in this series, we have built a to a DHT22 or use a different sensor such asa 
freelance writer and 2 couple of alarms: one for fire and gas BME280 (which also reads barometric pressure). 
editor with a focus i ‘ ; sac : : 
Spechicioey safety, the other for detecting intruders. The DHT11 combines a digital thermistor with 
eee ; This time we’re doing something a little different a Capacitive humidity sensor and outputs digital 
@philkingeditor , . ; ~ ; 
by using a couple of sensors to measure certain readings, so it’s easy to use. With the power turned 
weather conditions: temperate, relative humidity, off, connect the DHT11 sensor to Raspberry Pi as 
and ultraviolet light. One of the sensors gives an in Figure 1. We’re powering it from Raspberry Pi’s 
analogue output, so we’ll learn how to convert 3V3 pin, grounding it with a GND pin (both via 
that to a digital reading using an ADC. the breadboard side rails), and the digital output 
You'll Need (marked DOUT on the sensor) is going to GPIO14. 
>» DHT11 sensor 
cba Connect DHT11 sensor 
> UV sensor The DHT11 sensor measures temperature Install DHT11 library 
magpi.cc/uvsensor and relative humidity. We’re using one from the With the DHT11 sensor wired up, turn on 
> MCP3008 ADC Waveshare Sensors Pack, available from The Pi Hut Raspberry Pi. You should see the sensor’s red 
magpi.cc/mcp3008 (magpi.cc/wavesensors), and also sold separately. power LED (on the right) light up. 
> Jumper wires You can buy a similar DHT11 sensor elsewhere, Since the DHT11 outputs its data in binary form 
sometimes without the PCB, or you could upgrade to the GPIO14 pin, we’ll need a way of converting 
that into decimal numbers. The easiest way is to 
EEEEITATEEEE = aecoe wd use a ready-made Python library. We’re using 
ake 3 ork szazo’s DHT11 library, which can be installed with 
eesti the following Terminal command: 
seees tenes as pip3 install dht11 






icc oe a 


SEPP EEEEIa 


Temperature and humidity test 
To begin, we’ll create a simple Python 






shea GQ BQ a 
iftitinane . 


> Figure 1 The wiring 





se ee 


diagram for the oe (ft 8ene te P 
weather station, . a tease ea program (dht11_test.py), to read the sensor’s 
uae Aiea teeee | temperature and humidity outputs. From the 

and ADC _ ee desktop menu, go to Programming > Thonny IDE. 
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The MCP3008 ADC 
converts analogue outputs 
to digital for Raspberry Pi 


As our DHT11 library uses the RPi.GPIO Python 
library, we import that as ‘GPIO’ at the top of the 
code. We then initialise the GPIO and do a standard 
clean-up to reset all pins to inputs. 

Within an infinite while True: loop, we read an 
instance of the GPIO 14 pin value. If the result is 
valid (i.e. not an error), we print the temperature 
and humidity values to the Shell. In our print 
statement, the %-3.1f format parameter sets each 
output to a minimum three digits including one 
decimal place. We add the end = "\r\" parameter 
so the message is always printed on the same line. 

Run the dht11_test.py code and check that you 
are getting realistic readings. Try breathing on the 
sensor to increase both temperature and humidity. 


Add an ADC 

The Waveshare UV sensor (GUVA-S12SD) 
we’ re using outputs an analogue signal, so we’ll 
need to convert that to a digital value using an ADC 
(analogue-to-digital converter). We’re using the 
MCP3008 ADC, which has eight input channels. 

Since this chip uses the SPI interface, we’ ll need 

to enable SPI in the Raspberry Pi Configuration tool. 
It’s also best to enable full SPI support in Python 3. 
To do so, open a Terminal window and enter: 


sudo apt-get install python3-spidev 


With the power to Raspberry Pi turned off, it’s 
time to wire up the ADC. Place the MCP3008 in the 





— 


— 


The DHT11 sensor measures 
oXo)namk-van) e-1c- lel ao lale| 
celkela\Vemalelaalreliayg 


The UV sensor detects 
Ulhues\ Wile) K=1m ble] aim=lale malt 
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dht11_test.py 


>» Language: Python 3 


QQ@1. import RPi.GPIO as GPIO 
Q02. import dhti1 

003. 

004. # intialise GPIO 

Q@0@5. GPIO.setwarnings(False) 
Q06. GPIO.setmode(GPIO.BCM) 
Q07. GPIO.cleanup() 


middle of the breadboard, straddling its central 
eroove. Make sure it’s the correct way round, as 
shown in Figure 1, with the top of writing on top of 
the ADC nearest Raspberry Pi. 

Now connect the jumper wires as in Figure 1. 
Two of them go to the ‘+’ breadboard power rail, 
connected to a 3V3 pin; two others are connected 
to aGND pin via the ‘-’ rail. The four middle legs 
of the ADC are connected to the SPI interface 
on Raspberry Pi: GPIO pins 8 (CEO), 10 (MOST), 9 
(MISO), and 11 (SCLK). 
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Off board 


We've placed our 
DHT11 sensor on 
the breadboard, 
but you could 
wire it directly 

to Raspberry Pi's 
GPIO pins. 





008. 

Q@09. while True: 

Q10. instance = dht11.DHT11(pin = 14) 

Q11. result = instance.read() 

Q12. if result.is valid(): 

Q13. print("Temperature: %-3.1f C" % result.temperature, 


"Humidity: %-3.1f %%" % result.humidity, end = "\r") 
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uv_test.py 


>» Language: Python 3 


Q01. from gpiozero import MCP3008 


Qe2. 

Q@3. uv = MCP3008(2@) 

204. 

Q@@5. while True: 

Q06. print("UV: %-3.5f V" % (3.3 * uv.value), end = "\r") 





uv_iIndex.py 


>» Language: Python 3 


Q01. from gpiozero import MCP3008 


Q02. 

Q@3. uv = MCP3008(0) 

204. 

Q@0@5. def uv_range(): 

006. global uv_mv 

007. global uv_index 

008. uv_mv = int(3300 * uv.value) 
Q09. if uv_mv in range (0,227): 
Q10. uv_index = @ 

Q11. elif uv_mv in range(227, 318): 
Q12. uv_index = 1 

Q13. elif uv_mv in range(318, 408): 
Q14. uv_index = 2 

Q@15. elif uv_mv in range(408,503): 
Q16. uv_index = 3 

Q17. elif uv_mv in range(503,606): 
Q18. uv_index = 4 

Q19. elif uv_mv in range(606,696): 
Q20. uv_index = 5 

Q21. elif uv_mv in range(696, 795): 
Q22. uv_index = 6 

Q23. elif uv_mv in range(795,881): 
Q24. uv_index = 7 

Q@25. elif uv_mv in range(881,976): 
Q26. uv_index = 8 

Q27. elif uv_mv in range(976,1079): 
Q28. uv_index = 9 

Q@29. elif uv_mv in range(1079,117@): 
030. uv_index = 10 

Q31. elif uv_mv >= 1170: 

Q32. uv_index = 11 

Q33. 

Q@34. while True: 

Q35. uv_range() 

Q36. print("UV index: ",uv_index, end = "\r") 
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Connect the UV sensor 
With the ADC wired up to Raspberry Pi, 
we can now add our UV sensor to the setup. As in 
Figure 1, we connect its VCC pin to 3.3V via the 
breadboard power rail, and its GND pin to GND on 
Raspberry Pi via the breadboard ground rail. 
Finally, we connect the sensor’s AOUT (analogue 
out) pin to the MCP3008’s channel 0 pin, as shown 
in Figure 1. You could wire it to any of the eight 
channels on that side, but we’re using this one in 
our code. 





UV test 


Let’s create a simple program to test the 
sensor. In the uv_test.py listing, this time we’re 
using the GPIO Zero library as it has a handy 
MCP3008 class, which we import at the top. We 
assign the uv variable to the MCP3008’s channel o 
to read the connected sensor’s analogue output. 

In awhile True: loop, we multiply the digitally 
converted sensor output (which ranges from 0 to 
1) by the 3.3 maximum voltage to get an accurate 
voltage reading. If you’re indoors, it should be 
very low. To test it, you could move the sensor 
outside, or just hold it through an open window. 
Alternatively, you could try shining an ultraviolet 
light (such as from a counterfeit currency detector) 
onto it. You should see the output value change. 


07 UV index level 
We’re getting an accurate voltage reading 
from our UV sensor, but what does it mean® We 
need to convert it to the international standard UV 
index for it to be useful. 

In the uv_index.py listing, we create a uv_range 
function with a series of if and elif statements to 
check which range of values the reading (converted 
into microvolts in the uv_mv variable) falls into and 
then set the UV index level (uv_index) accordingly. 

Note: We’ve estimated the ranges for this based 
ona table of typical voltage values for each index 
that we found online for the sensor, but it may vary 
depending on temperature. 


Bringing it together 

Finally, let’s combine the code with our 
earlier DHT11 program to read both sensors and 
print the appropriate weather information, in the 
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DOWNLOAD 
weather.py THE FULL CODE: 


y) magpi.cc/github 









» Language: Python 3 


Q01. import RPi.GPIO as GPIO 
QQ@2. import dhti1 
Q03. from gpiozero import MCP3008 








004. 
Q@05. # intialise GPIO 
A Testing the UV sensor with ultraviolet light. It needs Q06. GPIO.setwarnings(False) 
to be of the correct wavelength to be sensed @07. GPIO. setmode(GPIO. BCM) 
Q08. GPIO.cleanup() 
weather. py listing. We can use both the RPi.GPIO Qe9. 
and GPIO Zero libraries (the latter is based on the Q@10. uv = MCP3008(@) 
former), but we need to initialise the GPIO pins Q@11. 
before setting any GPIO Zero values. Q@12. def uv_range(): 
We include our uv_range function to determine Q@13. global uv_mv 
the UV index and add a call to it in the while True: Q14. global uv_index 
loop. We also add its output to the print function. Q15. uv_mv = int(330@ * uv.value) 
Q16. if uv_mv in range (0,227): 
Q17. uv_index = @ 
Q18. elif uv_mv in range(227, 318): 
Take it outside Q19. uv_index = 1 
If you want to locate your weather-sensing 20. elif uv_mv in range(318, 408): 
project outside, you’ll need a weatherproof case Q@21. uv_index = 2 
for the electronics. Alternatively, you could even Q@22. elif uv_mv in range(4@8,503): 
house it in a couple of connected drainpipe bends, Q@23. uv_index = 3 
as we used for an air sensor project in The MagPi Q24. elif uv_mv in range(503,606): 
issue 92 (magpi.cc/92) — in which case, it’s best to Q25. uv_index = 4 
use a Raspberry Pi Zero W to save space. Q@26. elif uv_mv in range(6@6,696): 
You’ ll need to power the project via an extended Q27. uv_index = 5 
USB cable. Assuming you want to read the outputs Q28. elif uv_mv in range(696, 795): 
from it remotely, via SSH or possibly a web Q@29. uv_index = 6 
dashboard, you’ll also need to connect Raspberry Q30. elif uv_mv in range(795,881): 
Pi to your router — if doing so wirelessly, depending Q@31. uv_index = 7 
on the project’s distance from the router, you may Q@32. elif uv_mv in range(881,976): 
need a WiFi range extender. Q@33. uv_index = 8 
Q34. elif uv_mv in range(976,1079): 
Q35. uv_index = 9 
Q36. elif uv_mv in range(1079,1170): 
Taking it further Q37. uv_index = 10 
We have made a very basic weather station. To Q38. elif uv_mv >= 1170: 
improve it, you could add a barometric pressure Q@39. uv_index = 11 
sensor such as the BMP280 - or switch out the 242. 
DHT11 for a BME280, which measures temperature, Q@41. while True: 
humidity, and pressure, but you’ll need a different Q42. uv_range() 
Python library for that. Q43. instance = dht11.DHT11(pin = 14) 
If locating it outdoors, you could also add special Q44. result = instance.read() 
weather sensors such as an anemometer (wind Q45. if result.is valid(): 
speed), rain gauge, and wind vane, as featured e046. print("Temperature: %-3.1f C" % result.temperature, 
in the SparkFun SEN-15901 Weather Meter Kit "Humidity: %-3.1f %%" % result.humidity, "UV index: ", 
(magpi.cc/sfweatherkit). uv_index, end = "\r") 


Next time we’ll use moisture and liquid level 
sensors to monitor a plant. See you then. #/ 
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Composite video with 
Raspberry Pi Zero 2 W 


Raspberry Pi Zero 2 W continues support for composite 
video out, making It g great candidate for retro projects. 
You'll have to get the soldering tron out, though 





PJ Evans 





PJ is a writer, software 
engineer, and 
tinkerer. His ambient 
music collection has 
been described as 
“inspiring” (PJ Evans) 
and “just a load of 
random noise” (Mrs 


Evans, music teacher). 


twitter.com/ 
mrpjevans 


You'll Need 


> Raspberry Pi 
Zero 2 W 
magpi.cc/zero2w 


>» RCA male plug 
terminal block 
magpi.cc/rca 


> 30AWG 0.05 mm 
silicon wrapped 
wire (or similar) 
magpi.cc/30awg 


>» TV or monitor with 
RCA composite 
video input (PAL 
or NTSC) 


incorporated some form of composite video 

output, from the RCA connector of the 
original to the integrated 3.5mm video/audio jack 
of current models. The Zero range also supports 
composite out, but requires a little work on the 
Owner’s part. The latest Raspberry Pi Zero 2 W has 
access and you can get a signal. Composite is a great 
medium for retro projects, helping to recreate the 
authentic look of retro games. It’s also handy for 
connectivity where HDMI isn’t an option. Here we’ll 
show you how to get that slightly fuzzy video feed. 


E very full-size model of Raspberry Pi has 


Choose and prepare your 

operating system 
We’re sure you’ |l be interested in taking the all- 
new Bullseye release of Raspberry Pi OS with 
Desktop for a spin. However, have a think about 
the needs of your project. If you’re interested in 
recreating the intended aesthetic of 1980s video 
games, check out RetroPie (retropie.org.uk) 
or, if you’re driving an old TV showing vintage 
programmes, maybe Raspberry Pi OS Lite will save 
you precious resources as it can play video using 
OMXPlayer from the command line. We’re going to 
eo for the Desktop version. As ever, prepare your 
microSD card, and make sure everything is up-to- 
date before continuing using Software Update. 
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Find the pads 


On the original Raspberry Pi Zero, 
composite video access was via two through- 
hole soldering points; on Zero 2 W, access to the 
composite signal has been replaced with PCB test 
pads on the reverse of the board. These small, flat 
discs are normally intended for using logic probes 
to test parts of a PCB. However, they have been 
repurposed here for their space-saving properties. 
On the back of the PCB, look near the HDMI 
connector for a pad marked TV and one near it 
marked GND. We’re going to solder on to these. 
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Video Out (+) Ground (-) 


A These PCB test pads allow us to tap the composite 
video feed. Make sure you get the right ones! 


These wires connect to small 
‘test pads’, so a steady hand on 
dal-mcxe)Ke(1alale Micelan oe-manlecia. 
























Measure up 

Composite video is not what is termed 
a ‘balanced’ signal. It’s analogue in origin, not 
digital. What this boils down to is ‘the shorter the 
better’, as a composite video signal will degrade 
over distance. It’s also sensitive to external 
electrical interference. As we do not want to be 
resoldering on to the small pads in the future, be 
mindful of how much wiring you need (although 
always allow yourself a little bit more for mistakes). 
As we are using very thin wire in this project, you 
may also want to consider an additional sleeve or 
heat-shrink covering to protect the signal further. 


Prepare your wiring 

As the PCB pads are so small, we’ve opted 
fora 30AWG silicone-sleeved wire. This has two 
important properties. Firstly, the wire is very small, 
helping us to hit our target. Secondly, the silicone 
allows the wire to flex freely, so it is much less 
likely to snap off the pad through wear and tear, 
unlike nylon-covered wires. That said, if you don’t 
have this type of wire, that’s OK, but be careful with 
soldering and handling. Having worked out your 
optimum length, cut two equal length pieces of 
wire and strip the sleeve on all ends, as short as you 
dare on the PCB pad side, and enough on the other 
to fit the RCA screw terminals without poking out. 


We've chosen this screw-block RCA 
fofe} a] at=vei Ko) ai ce) m-J1an) e)t(eliavem oleimycelemer-lal 
Yo) Ke{=)mre)al-mlame)t-(X- Mi mYelem e)a-1i-)6 


Get soldering 

Take your time with this next step. Start 
by coating the ends of the two wires with a small 
amount of solder (‘tinning’ or ‘silvering’). Watch 
for any protrusions that could cause a short circuit 
and if the ends are too long, trim them with snips. 
Next, solder one wire to the TV pad and another to 
the GND pad (it’s common to use a black sleeved 
wire for GND). We recommend carefully mounting 
the Raspberry Pi Zero 2 in a PCB holder or ‘helping 
hands’, and holding the wire in place with some 
masking tape. 


Tidy up and wire up 

As gently as possible, secure the wire close 
to the solder points so that any inadvertent pull on 
the wire will not cause it to snap. You could use a 
piece of sticky tape or a dab of hot glue. Now, if you 
wish, you can carefully twist the two wires together 
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Alert! 


Although not part of 
this project, opening 
up a CRT television is 
very dangerous, risking 
electric shock. Be careful 
if you consider putting a 
Zero 2 W inside a CRT. 


magpi.cc/crt 


What about 
gudio? 


The Raspberry 
Pi Zero 2 W does 
not have audio 
out (except for 
HDMI), so if you 
need analogue 
audio too, try an 
inexpensive USB 
sound adapter. 





Warning! 
Hot solder 


Soldering irons get very 
hot, and stay hot for a 
long time after they're 

unplugged. Read up 
on soldering before 
connecting the wires. 


magpi.cc/soldering 
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tell the operating system that is what we would like 
to do. Connect up toa HDMI monitor and boot up 
(or SSH in). Open a Terminal window and run: 


sudo raspi-config 


Go to Advanced, then Composite, and select 
‘Enable’. Go back through the menus to exit. When 
asked if you want to reboot, select ‘No’ and shut 
down the operating system. Now, connect your 
composite cable to the TV/monitor, select the 
correct input source, and boot up. You should get 
video output right away. 


ov@ Uses antenna fechnotoa: 
licensed from Proant AB, 


OG 





Screen adjustments 

If you are used to a ‘regular’ monitor, you 
may be surprised to find your Raspberry Pi OS 
desktop has significantly less real estate than 
before. Composite output is at a fixed resolution of 
720 x 576 pixels (PAL signal) and cannot be 
changed. Also, don’t expect comparable image 
quality, as composite video is an analogue signal, 
unlike digital HDMI. If you find the image is too big 


Use tape or tack 

to steady the wires 
before soldering, and 
make sure the PCB 
cant move about 


so they don’t flap about. If you’re adding additional 
shielding, this is the time to do it. Finally, connect 
the other ends of the wires to the terminal block. 
The wire from GND goes to the negative (-) 
terminal and the other wire to positive (+). 


Configure Raspberry Pi OS 
Before we can display the Raspberry Pi OS 
desktop over a composite connection, we need to 


and disappearing off the edge of the physical 
screen, have a look at your TV’s settings: some have 
a zoom or overscan feature that can cause this. 


pi@rca: ~ 


Top Tip 


Raspberry Pi Software Configuration Tool ‘raspi-config? 


Al Expand Filesystem Ensures that all of the SO card is available 


Pogo pins A2 GL Driver Enablerdisable experimental desktop GL driver 
A3 Compositor Enable‘disable xc r composition manager 
If you don't Ad Network Interface Names Enable-disable predictable network if names 


AS Hetwork Proxy Settings Configure network Besos settings 


fancy soldering AS Glamor : east ge E gla 5 shies acceleration = 


directly onto your 
Raspberry Pi Zero 
2 W, investigate 
pogo pins: 
spring-loaded 
pins designed to 
connect to PCB 
test pads. 


AA Composite _ 


Before we can use 
composite video, it has 
to be enabled using 
raspi-config 
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Troubleshooting 

No video? Here are some things to try. 
First, ensure that you have soldered to the 
correct pads. The positive pad is marked TV 
with the label to the right of the pad. The pad 
to the left of GND is your ground wire. It’s very 
cramped on the PCB and this can be confusing. 
Also double-check you’ve wired GND to the 
negative (outer part) of the RCA connector. 
Make sure your TV is on the correct input. If 
the video quality is unacceptable, shorten the 
wiring or move your Raspberry Pi Zero 2 W 
closer to the TV. 


Try out dg retro game! 

We’ve now covered the how of a 
composite video output, so let’s look at the 
why. There is lots we can do with composite, 
especially in terms of easy compatibility, and 
one of the most fun is retro gaming. Although 
we can run old games using HDMI, this level 
of sharpness was never intended by the 1980s 
eraphics designers, who used all kinds of tricks 
to use the ‘fuzziness’ of a composite signal to 
their advantage. The result of using composite 
video is a much more faithful representation of 
the artists’ work. Check out RetroPie and Lakka, 
both great gaming platforms. 


On old TVs 


For a true retro experience, try out our 
Raspberry Pi Zero 2 W modification using an 
original CRT TV. Most will accept the composite 
video input using an RCA jack like ours, but 
some will have a SCART connector. Adapters to 
make these work are cheap and readily available. 
Although new CRT-based TVs are almost 
impossible to find these days, there are plenty 
of second-hand sets available. Just always be 
extra-careful with second-hand electronics. If 
you have a plan to place the Zero 2 W inside the 
TV, please read up on the dangers of opening up 
a CRT set — or, better still, don’t do it at all. 


Over to you 

Raspberry Pi Zero 2 W is an astonishingly 
powerful device for its price and size. At speeds 
that rival even Raspberry Pi 3 and its siblings, 





to be able to secrete one of these devices away and 
produce old-school video output is fuel for the 
imagination. Rather than add to landfill with that 
old TV set, why not create a random vintage TV 
show player using YouTube? Or, upcycle a broken 
games console for retro gaming how it should be. 
You could even add a Raspberry Pi Camera and add 
the setup to a low-cost CCTV system. As ever, it’s 
over to you. H 
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A Weused an RCA plug 
in our project, but you 
could use a socket with 
a connecting 
lead instead 





A Here's the result on 
a LCD monitor. This 


screen overscans the 
image, So we've lost 
a bit of the desktop. 
Most will allow you to 
adjust this 
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Make a binary clock 
with Raspberry P1 Zero 2 W 


Part art installation, part mathematical curiosity, this clock 
uses Blocks of light to display the time as ones and zeroes 


Hack the hardware 
Raspberry Pi Zero 2 W lacks the physical 





very 1960s sci-fi movie computer was awash 
z with blinking lights, yet here we are — living 








in the future — and they’re nowhere to interface required to communicate with the Scroll 
be seen. Unless you have a binary clock. Rather pHAT HD panel, so your first job is to solder a 
than using hands or digits, our Raspberry Pi Zero 40-pin male GPIO header. The Scroll pHAT HD 
2 W-based timepiece opts for LEDs, illuminating is supplied with a female header, which you’ 11 
them to indicate the ones and zeroes (pun also need to solder to the pHAT. Once they’ve 
: coincidental) with which it tells the time. It takes both attached to their respective boards, press 
Nik Rawlinson a bit of practice to get used to reading the time this them together to make the connection. We’ve 
way, but you’1l soon become proficient at adding used Pimoroni’s GPIO Hammer Header kit. The 
os eek the value of each column. In the meantime, just Male + Female + Installation Jig option (£7/S10, 
wielding, single- enjoy the hypnotic display. magpi.cc/hammerheader) contains all you need, 


board computing 
fan who likes 
hyphens and 


remembers what Hours appear on the top 


that icon on the 


ay Com lal=x-war= lave Maalialeicars 
save button depicts. 


fo) am Nats mAV(om llal=som el) kel) 
nik.co.uk 


You'll Need 


> Scroll PHAT HD 
magpi.cc/ 
scrollphathd 


> pHAT Diffuser 
magpi.cc/ 
phatdiffuser 


h{=1ere) ale (oie) a=Bo ale).ame) am al 


bottom line, but are easily 

> Male 40-pin } removed if distracting 
HAT Header or 
Hammer Header 
magpi.cc/header 
magpi.cc/ 
hammerheader 
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- 





A lf you're using a Raspberry Pi without integral GPIO pins, you'll 
need to add your own 


aside from the hammer, and is easier and quicker 
than soldering. 


Attach the diffuser 


Because the ‘digits’ on our clock will be 
rendered in binary, they’1l be composed of zeroes 
and ones. To indicate this, we’ll dimly illuminate a 
block of LEDs for each zero, and brightly illuminate 
the blocks that represent a one. To maximise the 
contrast, we’ll set the bright LEDs to shine at 100%, 
but the dim ones at just 20%, and use a diffuser 
to soften them. This not only gives the project 
an attractive bokeh feel, but makes the brightest 
LEDs less harsh. Use the screws supplied with the 
diffuser to attach it to the Scroll pHAT HD, with two 
nuts on each screw between the diffuser and the 
panel to maximise the spread. 


Enable the interface 

Every Raspberry Pi, including Raspberry Pi 
Zero 2 W, sports the 12C multi-device bus, which is 
used to communicate with attached peripherals like 
the LED panel that we’re using to display the time 
on our clock. Go to Menu > Preferences > Raspberry 
Pi Configuration, choose the Interfaces tab, and 
set 12C to Enabled. Set SSH to Enabled and you’ 11 
be able to access the clock remotely from another 
computer with SSH with: 


ssh pi@<IP> 


... replacing <IP> with the IP address of your 
Raspberry Pi (hover the mouse over your network 
icon in the menu bar to reveal it). 


Install the libraries 

Although Raspberry Pi OS has Python built 
in, it doesn’t include the libraries required to 
address the Scroll pHAT HD. You’ll need to install 


these at the command prompt. In a Terminal 
window on Raspberry Pi, or remotely if connected 
via SSH, type: 


curl https://get.pimoroni.com/scrollphathd 
| bash 


Press ENTER. Follow the prompts to install the 
libraries and included examples, which are worth 
examining in a code editor like Thonny, to get a 
better idea of the pHAT’s full potential. 


Write the code 


Either use Thonny to type in the code from 
the binary.py listing here or download it from 
GitHub. Save it as binary.py in your user folder. 


Before we run it for the first time, we’ll explain how 


it works. The first line: 
# !/bin/python3 


...tells the operating system where to find the 
Python interpreter, and the three lines that follow, 
each of which is preceded by ‘import’, call the 
libraries that the code uses to calculate and render 
the time. These are immediately followed by a 

line that informs the user that the binary clock is 
running, and how they can quit it. This will only 
appear if the routine is called at the command 
prompt. We’ll be invoking it using cron so, in most 
cases, this won’t be seen. 


A We've added a diffusion layer 
to soften the glow of the 
brightest LEDs and help them 
work as blocks, rather than the 
individual lights seen here 
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Warning! 
High temperatures 


If you solder the GPIO 
header, take care with 
the high-temperature 
soldering iron and flux. 


magpi.cc/soldering 


TopTip @ 


Seconds best 


If you find the 
updating seconds 
distracting, delete 
lines 34 to 40 

and adjust the 
hour and minute 
block heights 

to fill the gap. 
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A To read the time, 


add up the brighter 
columns, which are 
worth 32, 16, 8, 4, 2, 
and 1. Here, the clock 
shows 11:28am (and 
25 seconds) 


TopTip @& 


Using this in 
g bedroom? 


Reduce the 
brightness values 
on lines 17, 25 and 
33. A setting of 

0.0 is off, and 1.0 
is full brightness. 
Choose something 
between. 





Start a loop 


We now begin a never-ending loop with: 





while True: 


Everything below this is indented because it’s 

part of the loop. Further indents within it signify 
embedded loops, each of which ends when the code 
moves back to the left. The first thing we do inside 
our loop is to get the current time, with: 


now = datetime.datetime.now() 


This stores the year, month, date, hour, minute, 
second, and millisecond in the now variable, which 
is far more detailed than we need - and in the 
wrong format. So, we’ll extract and convert the 
components we need. 


07 Extract the binary variables 
The next three lines define three variables 

for hour (bhour), minute (bmin) and second (bsec). 
We’ve preceded each with a ‘b’ to signify to 
ourselves that they’re binary. Examining the bhour 
line in more detail, we’re first extracting the hour 
from the time stamp stored in the now variable with 
now.hour, then converting it to binary by making 
it an input for the binary conversion function, 
like this: 


bin(now. hour) 


Unfortunately, this doesn’t quite give us the 
answer we’re after as the function adds two extra 
characters to the front of the result ‘ob’ to signify 
that the string is binary, rather than decimal. 
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Strip out the surplus characters 
To remove the ‘ob’ characters we add [2: ] 
to the bin(now. hour) function, which instructs the 
interpreter to slice out the first two characters. 
Finally, because we need our time read-out to be 
right-aligned, so that it always counts from the ‘1’ 
column on our binary display, we add .zfill(6), 
which pads out the result by adding sufficient 
zeroes to the start to make it exactly six digits 
long. The result, if it was 6pm (1800 hours), would 
therefore be 010010. And for 6am (0600 hours) it 
would be 000110. We repeat this for the minute 
(bmin) and second (bsec) readings. 59 minutes or 
seconds would become 11101. 





M The first thing we do 
Inside our loop Is to get 
the current time @ 


Understand the layout 

The Scroll pHAT HD has 17 columns and 
seven rows of LEDs. We’1] use these to create six 
2x2 blocks of LEDs to represent the hours, six of 
the same, below, to represent minutes, and six 2x1 
blocks for seconds on the bottom row. The rows 
are numbered from zero to six, and the columns 
from zero to 16, which we need to bear in mind 
when telling the panel where to position the upper 
left corner of each block. The line of code on which 
we specify this will also define the block’s width, 
height, and brightness. 


Build your blocks 

We now define a new variable called pos, 
to represent the column position as we arrange 
the illuminated blocks, then create new loops 
for the hours, minutes and numbers. Each loop 
breaks the six binary digits of each number down 
into their individual ones and zeroes, so will cycle 
through six times apiece. In each cycle, they 
examine the relevant digit and, if it’s a zero, set 
a brightness variable to 20% (0.2) or, if it’s a one, 
to 100% (1.0). It then creates a block in memory 
using the scrollphathd. fill command, which 
combines the brightness, value of pos (column), the 
row, and the width and height of the block (2*2). 
The pos variable is then incremented by three, 
and the process repeats for the next digit in the 
binary value. 





A |f you only want to display hours and minutes, you could 
increase the height of those blocks to three rows, as 
we've done here 


Output the time 

By the time the routine has cycled through 
the three loops for hour, minute, and second, 18 
individual blocks of light will have been defined 
but, so far, they only exist in memory. To send 
them to the pHAT, we use the command: 


scrollphathd. show() 


This tells Python to output the buffer to the Scroll 
pHAT HD. Finally, we pause for a second with: 


time.sleep(1) 


And then the overall loop begins again, to update 
the time so it’s correct for the next second. 


Launch at boot 

You can run the routine from the command 
prompt by navigating to your user folder and typing 
python3 binary.py. However, we want this routine 
to launch at boot so that as soon as the computer is 
plugged in, it starts working as aclock. Type: 


crontab -e 
If you’ve never edited crontab before, you’ ll be 
asked which editor you want to use. Select Nano 
(option 1). Key down to a blank line at the bottom of 
the file and type: 


@reboot python3 /home/pi/binary.py & 


Press CTRL+X, press Y to save, then reboot. Wi 





033. 


040. 
041. 
042. 
043. 


DOWNLOAD 
binary.py THE FULL CODE: 


> Language: Python wy) magpi.cc/binclock 


TUTORIAL | Mag?hi © 






# !/bin/python3 


import datetime 
import time 
import scrollphathd 


print('Binary clock is running. Press ctrl-c to stop.') 


while True: 
now = datetime.datetime.now() 
bhour = bin(now.hour)[2:].zfill(6) 
bmin = bin(now.minute)[2:].zfill(6) 
bsec = bin(now.second)[2:].zfill(6) 
pos = @ 


for x in bhour: 


if x == *@": 
bright = 0.2 
else: 
bright = 1.0 


scrollphathd.fill(bright, x=pos, y=0,width=2, height=2) 
pos = pos + 3 
pos = @ 


for x in bmin: 


if x == '@': 
bright = 0.2 
else: 
bright = 1.0 


scrollphathd.fill(bright, x=pos, y=3,width=2, height=2) 
pos = pos + 3 
pos = @ 


for x in bsec: 


if x == *@"; 
bright = @.2 
else: 
bright = 1.0 


scrollphathd.fill(bright, x=pos, y=6,width=2, height=1) 
pos = pos + 3 


scrollphathd. show() 
time.sleep(1) 
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Figurel > 

The white buttons are 
used to play notes, 
the coloured buttons 
are used to move 
between tracks. The 
cheese was delicious! 


ICO musical 
cheese Dox 


Create syncopated rhythms and computer-generated music using a Pico 





Rob Miles 





wW @robmiles 


Rob Miles has been 
playing with hardware 
and software since 
almost before there was 
hardware and software. 
You can find out more 
about his so-called life at 
robmiles.com. 


ake a portable MIDI controller that 
you can use to create complex 
rhythms and musical sequences 
and use as a tiny keyboard. In 
a cheese box. [he article ‘Make 
Music with Pico’, in HackSpace 
magazine issue 46, showed how easy it Is to use 
a Raspberry Pi Pico device to send MIDI notes to a 
synthesizer. We are going to build on that to create 
a MIDI instrument, the ‘Pico musical cheese box’, 
as shown in Figure 1. The musical cheese box uses 
a ring of twelve pixels to display notes, and twelve 
buttons for user input. You can use the cheese box 
with a synthesizer program that connects to MIDI, and 
there is also a specially written Pure Data patch for it. 
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INSIDE THE BOX 

Figure 2 shows the contents of the box. There are 
quite a lot of wires, but the task of assembly wasn’t 
too onerous. The box contains a twelve NeoPixel 
ring and twelve buttons which are connected 

to a Raspberry Pi Pico. Each button has its own 
dedicated input pin on the Pico. 

Figure 3 shows the circuit for the box. The button 
signals are pulled low when a button is pressed. To 
simplify the wiring, the ground signal is connected 
in a ring around the switches. The pixel ring display 
only needs a single data connection, along with 
power and ground connections. 

The prototype used wire wrap wire for the 
connections. One end was wrapped round pins on 





the Pico device, the other end was hooked inside 
the hole in the pin on the switch, and then soldered 
in place as shown in Figure 4. All the switch 
connections were encased in heat-shrink tubing. 


HARDWARE MAPPING 

The buttons are used by the CircuitPython program 
running inside the Pico that controls the device. 
The program contains Note and Select classes to 
represent the two types of button on the device. 
Note and Select objects are created with hardware 


pins and pixel number settings when the box starts. 


notes = ( 


Note(pin=board. 
Note(pin=board. 
Note(pin=board. 
Note(pin=board. 
Note(pin=board. 
Note(pin=board. 
Note(pin=board. 
Note(pin=board. 


) 


selects = ( 


GP6 , pixel=11,num=0), 
GP5,pixel=10,num=1), 
GP4,pixel=9,num=2), 
GP3 , pixel=8, num=3), 
GP2,pixel=7,num=4), 
GP1,pixel=6,num=5), 
GP12,pixel=5,num=6), 
GP11,pixel=4, num=7 ) 


Select (pin=board.GP7,pixel=@,col=Col.RED), 
Select (pin=board.GP8,pixel=1,col=Col.GREEN), 
Select(pin=board.GP9,pixel=2,col=Col.BLUE), 


Select(pin=board.GP10, pixel=3,col=Col. YELLOW) 


) 


The code above is the Python that creates the 

collections of Note and Select objects that provide 
the user interface for the box. The note values are 
assigned a pin, a pixel number, and a note number 


You can use the 


cheese box witha 
synthesizer program that — 


W 


connects to MIDI 


which will be used with they are played. The select 
values are assigned a pin, a pixel number, and the 
colour of the button which will be used to select 
the appropriate voice. This colour is then mapped 
to an instance of the appropriate Voice class. The 
mappings opposite were used for the first cheese 
box. You can change them to match the hardware 
that you build. Look for the statements in the 
program (they are near the bottom), and change the 
GP and pixel values to match your hardware. 


BOX SOFTWARE 
You can download the software for the box from the 
GitHub site for this project: hsmag.cc/CheeseBox. 
The software Is written in CircuitPython, which can 
be installed on your Raspberry Pi Pico using the 
image from here: circuitpython.org/downloads. 
The software uses the Adafruit adafruit_bus_device 
and adaftruit_midi libraries, which need to be 
copied into the lib folder on the CircuitPython 
drive of your Pico. You can find these here: 
circuitpython.org/libraries. 

You can use Thonny (thonny.org) or Mu 
(hsmag.cc/MuEditor) on your computer to open the 
program and download It into your Pico. > 
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Figure 2 > 

The cables have been 
organised in two sets 
of six coloured wires 
(a red set and a green 
set), plus three (the 
yellow set) for the 
pixel. And there are 
still plenty of spare 
pins for more buttons 


YOU'LL NEED 


© ARaspberry Pi 
Pico 


} A12-pixel WS2812 
pixel ring (search 
for ‘WS2812 ring 12’) 


© 12~xcoloured 
push-buttons 
Ideally eight white 
buttons for the 
notes and a red, 
green, blue, and 
yellow button for 
the controls. The 
buttons should be 
non-locking, push 
to make 


€ Amicro USB 
cable to link the 
Pico to the host 


© Connecting wire 
The author used 
coloured wire wrap 
(search for ‘30 AWG 
wire wrap’) which 
needed a wire wrap 
tool (search for ‘wire 
wrap tool’). He also 
used a fair amount of 
heat-shrink tubing 


©  ARaspberry Pior 
machine running 
Windows, macOS, 
or Linux running 
Pure Data to make 
the sounds 


€ AboxThereisa 
3D-printable design, 
or you can just drill 
some holes for the 
lights and buttons 
in a cheese box and 
stick the pixel ring 
and Pico inside it 


© Screws You'll need 
some screws size 
M2 4mm in length 
to fix the pixel ring 
and Pico to the 
case (search for 
‘laptop screws’) 
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Figure 3 > 

This diagram took 
almost as long to 
draw as it took to 
build the hardware 





Figure 4 ® 

Wire wrap cable is 
single core, which 
makes it very easy to 
work with. It is also 
very flexible, so it is 
less likely to strain 
the connections at 
each end 





ri 





Different elements in the application are 
managed by software objects called classes 


a 
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White NB 








A full description of how the program works 

would take more space than we have for this article, 
but we can take a look at how it is structured. 
Figure 5 shows a simplified class diagram for the 
software. Different elements in the application 

are managed by software objects called classes. 
The Button classes (Note and Select) manage the 
information for the buttons. The Voice classes 
(Keyboard and Rhythm) manage the information for 
the voice tracks that are played. The Setting class 
holds setting information for a collection of setting 
values. The Step class is based on the Setting class 
and holds information for a step in a track. The 
MidiBox class contains lists of buttons and voices, 
and repeatedly updates them to keep the box 
running and provide the illusion of several things 
happening at the same time. 


MAKING TRACKS 

The software manages four performance tracks: one 
keyboard track and three rhythm tracks. A track is 
selected by pressing one of the coloured buttons. 
When a track is selected, the pixel next to Its 
selection button is lit in the colour of the button. The 
red keyboard track lets you play notes. When this 
track is selected (indicated by a red pixel next to the 
red button), the box starts a MIDI note playing when 
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A child class (one with 
col an arrow pointing 
to the class above 
it) inherits all of the 
value ee properties of the 
‘ . parent above it. The 


Settin i 
cols 


pin 


chan 


handler : ease 
items inside each 


pinel values 
class are the data 


Select values stored within it 
Figure 6 
num co ES base The two diagrams 
— See show the switches 


last_note last_note start_sequence around the outside 
ar - a stop sequence and the pixels in 
no of notes Pressed the middle 
SEQUENCE Pores 


last channel 


start_all_ sequences 


factor 


MidiBox track 
settings 


midi 
buttons —= 


Figure 6 shows how the buttons work for the 


OMENS 
ad re tune and rhythm tracks. When the red track is 
eae J selected, you can play notes just by pressing white 
ee buttons. When the green, blue, or yellow track Is 
ee selected, you use the white buttons to set steps in 
the sequence. The green rhythm track on the right 
of Figure 6 starts with two beats from the kick drum 
a white note button is pressed and stops the note (the red pixels) and ends with a ride cymbal (the 
when the button is released. yellow pixel). 
When a rhythm track is selected (by pressing a The rhythm track functions in the same way for 
green, blue, or yellow button), the box will display all three tracks. You can step through the options for 


the steps in the track and a moving white cursor that each step by repeatedly pressing the white button 
shows the position in the track. The user can select to change the colour of the pixel for that step. A 


beats to be played at points in the track sequence red step means ‘kick drum’. When the sequencer 
by pressing the corresponding white button. All reaches that step, it will send a MIDI note to play 
the sequencers run in parallel and work through that sound. 

a sequence of up to eight steps. Each step can Figure 7 shows the mapping of pixel colours 
produce a drum sound or a musical note. The speed to drum sounds. The number after each sound 

of each sequencer can be changed, as can the name is the MIDI note that will be sent to trigger 
length of sequence for that track. By making tracks that sound. These notes correspond to the 


of different lengths running at different speeds, you General MIDI standard for musical instruments 
can create surprisingly complex rhythms as tracks go (hsmag.cc/MIDI) so the cheese box will work with 
in and out of time with each other. most synthesizers. > 





yA (Out 1-10] 0s IOAN ss) 





HackSpace 


The white buttons on the box don't play successive 
MIDI note values. Instead, they play the notes from a 
particular musical scale. This is so that the box sounds 
musical when you play it. Different scales use different 
arrangements of gaps between the successive notes. 
The most common scale is the ‘major’ scale, but there 
are others. Some have fantastic names like ‘Phrygian’ 
and ‘Mixolydian’, as you can see in the Scale setting in 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 





Tune Track Rhythm Track Figure 8. You can experiment with different scales to AitanaleEndoln 
press white buttons press white buttons find the one that sounds best for a particular tune. more at hsmag.cc. 
to play notes to select beats 


Make a Pico musical cheese box | magpi.cc | 65 


WN MagPi | TUTORIAL 


Drums 
Off Kick 36 Snare 40 Tomtom48_ Ride 59 
pe SETTING UP 
Figure 7 > You adjust the settings for the box by holding down 


Each time you press 
a step button, the 
selected beat for 
that step moves to 
the next colour. If it 
reaches the end, it 
wraps around to 

off (black) 


the button for the selected track, and then setting 
the colour of pixels that are mapped onto setting 
values. If you press the red button when the red 
track is selected, the tune settings are displayed. 
Figure 8 shows the tune settings. There are 
seven different setting items. Each of them Is 


assigned a pixel and 
i" 


the value of the setting 


Figure 8 &® 

The pixel colours 
in the centre of the 
settings show 

the default 

setting options 


selected by stepping 
through the colours for 
that setting. There are 
also seven settings for 
the rhythm track... 
Figure 9 shows the 
rhythm settings for the 
green track. You can set 
the speed of the track in beats per minute. You can 
also set the pattern length and the ‘speed factor’. 
The speed factor is used to slow down a rhythm 
track. A factor of 1 means normal speed. A factor of 
2 means half speed, a factor of 3 a third speed, and 





Tune Settings 


Rhythm 





Volume 








Scale 





Major Minor Darian 





_ Phrygian 


Lorian 


Lydian 


Mixolydian 


Octave 


C2 


66 | magpi.cc | Makea Pico musical cheese box 


You can use the cheese box 
with any synthesizer, but you 
can also use it with a specially 

written Pure Data patch 






















Splash 55 Clap 39 Cowbell 56 


so on. You can also change the mode of a rhythm 
track to play notes rather than drums. This lets the 
track play short musical sequences. 


MAKING SOUNDS WITH PURE DATA 

You can use the cheese box with any synthesizer, 
but you can also use it with a specially written Pure 
Data patch. Pure Data is a programming language 
for creating music 
applications. You can 
find out more about It in 
the article in issue 47 of 
HackSpace magazine. 
Pure Data programs are 
expressed as a network 
of connected objects. 
The connections 
between the objects can 
be either individual values or audio streams. 

Figure 10 shows the Pure Data patch that 
generates sound output for the cheese box. It works 
as a ‘switching station’ which acts on incoming 
MIDI messages. The ‘notein’ object at the top left 
of the patch accepts Incoming MIDI messages and 
sends out the note number, volume, and channel 
(these are the three outputs along the bottom of the 
notein object). The patch uses spigot objects 
to control the flow of the data around the 
patch. Values will pass through the spigot 
if the right-hand input to the spigot 

is true. 
Any messages sent to MIDI 
channel number 1 are passed into 
the polyphonic object (poly) and 


W 


Midi Channel 








REE ———EE—t 
i 2 3 4 
—— (| | 
5 8 7 8 


Key sharp/flat 


Sharp Flat 


Key 





ot | =] =) STO) 





If you don't fancy 
buying some cheese 
just to get a box for 
your cheese box, you 
can download and 
3D-print a custom 
case. The designs 

are available at 

the GitHub site for 
this project: 
hsmag.cc/CheeseBox 


then on to a set of six note synthesizers. Messages 
sent to any other MIDI channel are stripped of 

their note off elements (these have no meaning for 
drums) using the stripnote object and then the note 
number is used to select the sound generator to be 
used. You will notice that the note numbers in the 
select object are the same as those in Figure 7. 
You can find this patch, along with installation 
instructions, at the GitHub site for this project: 
hsmag.cc/CheeseBox. At the moment, the note 
generators only output simple sine waves, but in 
the next issue of HackSpace magazine, we will be 
discovering how to use Pure Data to produce more 
interesting sounds and create a crackers controller 
to go with the cheese. 


Rhythm Settings 





Volume 








30 60 


Speed (bpm) 


&O 





120 
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Pure Data patch for the PICO MIDI 
Cheesebox 


Notes to channel 1 are sent to a note 
synthesizer which is 6 note polyphonic. 


Notes to other channels are used for 
rhythms. The note value is used to select 
the sound generator. 


S&S 





ALL the sound generators throw 
their output here to be 
converted into an audio signal 











Ei poly 6 1 by the dac 7 
/ | 
960 
clone note 6 1 














EUCLIDEAN FUN 
By changing the speeds of the tracks and playing 
notes and drums at different points, you can 
generate interesting sounds that change over time. 
These are called Euclidean rhythms. You can find 
out more here: hsmag.cc/Euclidean. Don't be 
afraid to experiment with the sounds. If you change 
the rhythm mode of a track to ‘Euclidian’, the 
cheese box calculates a note frequency by adding 
together note values from other Euclidian tracks. 
By careful choice of track speeds, you can create 
extended sequences of changing notes. Once you 
have something interesting, try changing the scale 
and listen to what happens. You can 
pick different octaves for the note 
playback so you can generate 
bass sounds too. Remember 
that there is no such thing 
as bad music, just stuff 
that only you like. O 
Figure 10 > 
Pure Data programs 
can run on a huge 
range of computers, 


from Raspberry Pi 
Zero upwards 


Figure 9 © 


Rhythm Mode 
7 By default, each 





Drums Notes Euclid rhythm track sends 
on a different MIDI 
_ channel so that the 
Midi Channel 


rhythms can be used 
to trigger different 
voices. However, you 
can select the MIDI 
channel for each track 
so that you can make 
the rhythm tracks play 
on the same channel 
as the keyboard 
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INfopassealuer-lareyemel-teehselenensa-leimeyal 
Raspberry Pi. By Rob Zwetsloot 





Pi that makes it really, painfully easy to get retro 

gaming working on a Raspberry Pi. However, did 
you know that some games run on Raspberry Pi OS without 
any form of emulation? And we don’t just mean Doom. 

Raspberry Pi is a computer after all, which means you 

can easily make games for it - we’ve done it several times 
ourselves with Python and Scratch. There are many games 
that have been released on or ported to Raspberry Pi, and we 
think it’s about time we show you some. 


if LW e love RetroPie. It’s a fantastic OS for Raspberry 
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stream games without the hassle 


on Raspberry Pi is to stream them from 
another PC using Steam Link — here’s 
how to set it up. 


T he quickest way to play modern games 


Install on Raspberry P1 OS 
Raspberry Pi OS has Steam Link in the repository, 
So you can easily install it! You can find it in the 
Software Installer, or simply install it from the 
Terminal using: 





You’ll find it in the main menu under Games - 
just make sure Steam is running on your main PC, 
plug in acontroller, and you’re good to go. 


M@ Raspberry Pi OS has Steam : 


Link in the repository, so you 
can easily install it! @ 


Install on RetroPie 


If you have a dedicated retro gaming Raspberry Pi 
setup, you can still make use of Steam Link. Go to 
RetroPie Setup, scroll down to Manage Packages, 
and then go to ‘exp’ for the Experimental 
packages. There you’ll find a steamlink package. 
Install it, and then find it in the Ports section of 
the main interface. 


sudo apt update : 
sudo apt install steamlink : 
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Xbox Cloud Gaming 


Want to try out the xcloud on Raspberry 
Pie Our friends at Pi My Life Up havea 
guide: magpi.cc/xcloud 


Steam Link tips! 


For the best experience, make sure at 
least one of the systems in this setup 
is connected via an Ethernet cable. 
Preferably your PC running Steam and 
your Raspberry Pi will both be wired. 
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Linux games running natively on a Raspberry Pi 


Wb Cos Koy ove) bE 


> magpi.cc/micropolis 


Created by the SimHacker team, this free and 
Open-source game is based on the original SimCity. 
For those unaware of it, it’s a simulation game 
which allows you to plan out and build a city while 
also facing any consequences your actions might 
result in. And, sometimes, giant monsters. 


How to install: 





sudo apt install micropolis : 


Foot Ofom beied Paty eee See 
Geb fee ML 
hece Tae 


tn SFT 


= 7 DL Nee aa ea 
moe Be Pee errata Sa Gar 
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- Freeciv 
> freeciv.org 
| As you may have gathered from the name, Freeciv is a clone of the Civilization 


- games, albeit the earlier ones. This version supports up to 126 people in 
- multiplayer, and has a load of mods and scenarios for you to play around with. 


; How to install: 


; sudo apt install freeciv-client-sdl 





— 


3 PhiadephiaB FM =— 
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SuperTuxKart 


Hurrican 
> supertuxkart.net 
> magpi.cc/hurrican 
This mascot kart racer includes mascots from This game describes itself as ‘THE ultimate Turrican Mega-Mix’, 
all your favourite libre operating systems and taking ideas from several instalments of the original franchise while 
software, including Tux, the mascot of Linux at the same time expanding on its universe. It’s a side-scrolling run- 
himself. This is a fun racer full of power-ups, much and-gun game with a killer soundtrack. 
like your Mario Karts, Sonic Karts, or Diddy Karts, __: 
and it even has a story! How to install: 


Follow the instructions here: magpi.cc/hurricaninstall 
How to install: 
Download from the main website or follow the 
instructions here: magpi.cc/tuxkartinstall 





: Pingus 
- > magpi.cc/pingus 
- ALemmings-style puzzle game with little penguins instead. Basically, you 


have to guide the penguins through a level using a variety of commands 
* you can give them, like dig, redirect, build a bridge, etc. Unfortunately, the 





== -_ 1 ti: = ; penguins do not have any regard for their own well-being. 
STM DEVELOPMENT TEAM ners SUPERTUXKART CELEBRATING THE NEW ENGINE 
=F JOERG HEMADGHS uc WARTAMKE GAGNON sass JEAN-WANUEL CLEENGON eo - How to install: 






— SSEOZONEONE wo CHRIS LEUTW OVER OAWTD GAN co DANIEL BUTUM uc GLENN DE JONGHE 
Qe ae 


THANKS TO GOMELE SUMMER'S CODE a QUR AWESOME COMMUNITY :) 


DOWNLOAD AT SUPERTUXKART.NET yi | aE ra 
: end 
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Ganes om hehe 


Indie games galore for Raspberry Pi 


Ben Was Assimilated 


> magpi.cc/benassimilated 


With a very cool, low-colour aesthetic, Ben Was Assimilated 
is a hack ‘n’ slash game where things only move as you do, 
resulting in careful deliberation and interesting tactics. It also 
has Roguelike elements, including a permadeath option for 
those wanting a real challenge. 


How to install: 
Get it from the link. 


Sail Sho St tt holst het Rad cha cfat hal “Pasta hel “Rasta onal ait 
HIE eo ee 2 * 
Baa ej ee * * a *| 
cs 3 % 
fie of Mn eed #4 i | 
fea ee fa 
fan [ee me) AO= oh 
it a it OR t $y UL URL SOE AME SR TS At 
Se ee ee ee eee ee rt | 
How Cow Tema Taw Some Tew Game Some lems iw Some Cow ewe Some Sem 35 i 
= os) m 


Be 28g 


ns 
= an 
HEY TT 

Sipe aye 


= 
E fon sae Ha 
ee es ed Te 


& 


POO OO lr 2A Me Bo Bo 
“ (2 (310 Bo 


an 
iy 
a 





— iTV li 
as Stu Tha Shed a a 
oe 51 O Sie a 

me ae 
5 oa ; Ce | : ars ful i 
Git za ead WOM Fad ad Sos a5; fil. ia 
os 25 15 WO bos ee as a) 
oe fan marl was saea it i) 


ITS LOOKING A BIT BLACK OVER BILLS MO 
ee Sm £6) &J1 #* We Fis Bo 
v “ (Ae (1 QO 


72 | magpicc | Raspberry Pi Gaming 


Art Treachery 


> magpi.cc/arttreachery 


This game was made for the British Library Labs 
Crowdsourcing Game Jam. You play an art thief who 
has to steal specific objects from a museum. It’s 
simple and short, but a pretty fun concept. 


How to install: 
Get it from the link. 


Teas lager, 

T Rare 6 nee job for you, 
Pisaoe bring =e 

BHArtwork with a Fobiobe ; 
on | 
Tt purt be free the yeaie 
TS to 1, 


| Becerafull 
Finch 





M@ You play an art thief who 
has to steal specific objects 
icelaamemaniesicielaan?? 
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Zombusters: Rl pee 
Raspberry Pi Edition TT 0} 1 
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> magpi.cc/zombusters 


A isometric, twin-stick shooter with Roguelike 
elements where you have to bust zombies with eS : | : 

pis “ae as eee. tee. eet 
guns. Lots of guns. You can also play with up to a. eh ds "7 oe } Bee Bede: 
four players on one Raspberry Pi for some excellent Oe —" ets ae i a 
combo zombie take-downs. 





How to install: 
Get it from the link. 


SpaceTrader 


> magpi.cc/spacetrader 


This game runs in the Terminal for a different 
kind of playing experience. You’re a trader in 
Earth’s space port, and need to make your way 
around a changing economy and pirate bands to 
make as much money as you can. 





How to install: 
Get it from the link. 


gray water 


> magpi.cc/graywater 


Another Terminal game, this game takes a darker 

turn into horror with this simple description: 

‘You enter an apartment building. You do not 4 oe | y Wa 6 er | 
know your neighbours.’ It’s not very long, but it 

is very effective, bringing new ideas to the classic 

command line-based game. 


How to install: 
Get it from the link. 
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made available to everyone, in most cases 

by releasing the source code. You can run 
them straight off your Raspberry Pi thanks to the 
community making them ARM-friendly. 


T hese games from yesteryear have been 





M As the space marine 
ByelelaamciehyAmV.elemale\i-mee 
fight off the forces of hell 


Doom (1993) 


> magpi.cc/doom 


A game so good, it defined a genre for years. 
Seriously — FPS games used to be called Doom- 
clones. As the space marine Doom Guy, you have 
to fight off the forces of hell with a large variety 
of guns and a rocking soundtrack. The source code 
was released by id Software in 1997, and became 
Open-source in 1999, which is why there’s been a 
long-running joke about trying to get every piece 
of tech to run it. 


How to install: 





: Beneath a Steel Sky (1994) 


- > magpi.ce/steelsky 


A classic point-and-click adventure game, Beneath a Steel Sky has been 

‘ available as freeware since 2003. It’s a cyberpunk story set in a dystopian 

- Australian future and... well it’s a story game, so we won’t spoil too much. A 
. sequel for it came out just last year, so it’s a great time to familiarise yourself 
- with it. 


How to install: 
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Minecraft (2011) 


Pam rit-ve|*) ered vite 9) | 


Minecraft Raspberry Pi Edition is a free game on 
Raspberry Pi. However, it has not been officially 
updated in many years. You can still hack it with 
Python to do fun things, and we’ve covered that 
in the mag before. Minecraft Raspberry Pi Edition 
Reborn is an effort to mod it to be much closer to 
the Minecraft you can play elsewhere - it’s still in 
development, though. 


How to install: 
Follow instructions on the website linked above. @ 
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Quake III Arena (1999) 


> magpi.cc/quake3arena 


Another id Software classic, and the granddaddy of 
multiplayer twitch shooters, Q3A was the bane of 
school IT administrators in the early 2000s because 
of how easily available it was. Only the demo data 
is free, but if you have a copy of the game, you can 
add the files yourself to get the full game. 


How to install: 
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-RETROGAMING | 


WITH 


_ RASPBERRY PI | 


Z2N° EDITION 


Retro Gaming with Raspberry Pi shows you how to set up a 
Raspberry Pi to play classic games. Build your own games console or 
full-size arcade cabinet, install emulation software, and download classic 
arcade games with our step-by-step guides. Want to make games? Learn 
how to code your own with Python and Pygame Zero. 








Y=] 0] ol ¢- yo) o)-)4 aa Le) 
retro gaming 


= Emulate classic 
computers and consoles 


= Learn to code your 
own retro-style games 


| lel em-maelane) (=) 
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BUY ONLINE: magpi.cc/retrogaming 
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Argon IR Remote 





DIMENSIONS: 
150mm «x 35mm 
x10mm 


POWER: 
2 x AAA batteries 


COMMUNICATION: 
Infrared 


HARDWARE 
COMPATIBILITY: 
Argon ONE & 
EON cases 


SOFTWARE 
COMPATIBILITY: 
LibreELEC or 
Raspberry Pi OS 


= 


Verdict 


Although the 
setup instructions 
could be 
improved, Argon4o 
has delivered a 
sleek, simple, and 
reasonably priced 
IR remote, both 
for Raspberry Pi 
media centres 
and homebrew 
projects. 


90 


> Argon40 » magpi.cc/argonir » £9/S10 


Looking for a sleek minimalist remote for your Raspberry Pi media centre? 
PJ Evans sits back on his sofa and gets clicking 


makes for a brilliant way to access 

your favourite sounds and movies. Add 
Argon4o’s sleek ONE case and it looks as good, if 
not better, as any other set-top box. There’s even 
mature software in the form of the LibreELEC 
operating system and Kodi media centre app. All 
that’s missing is an easy way to control the action. 
The eagle-eyed may have noticed the ONE case’s 
circuitry includes an IR sensor, and now Argon4o 
has made the companion Argon IR infrared remote 
control available. 

Thankfully, Argon4o has been watching 

other tech design teams rather than those of 
most modern TVs. What you get for your very 


U sing a Raspberry Pi 4 as a media centre 





A. Thelack of extraneous buttons and a small form factor make the 
Argon IR comfortable to hold and use 
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reasonable £9 is a minimalist, slim remote with 
just enough to make controlling Kodi a breeze. 
Basic directional control, selection, volume, and 
standard navigation work alongside a power button 
that works out-of-the box with any Raspberry Pi 4, 
regardless of operating system. It’s light too, at 
just 65 g with two AAA batteries. 


More than media 

If media centres are not your thing, or you have 
other epic plans for a remote control, Argon4o 
provides software that allows you to assign any 
key press to a button using the standard LIRC 
library with ease, making the addition of IR remote 
control to your project easier than ever before. In 
our tests, this worked flawlessly. However, we did 
have some issues configuring Kodi due to some 
missing steps in the supplied instructions. Once 
resolved, the remote performed admirably from 
across the room. Hl 


MA minimalist, slim remote 
with just enough to make 
controlling Kodi a breeze 





A You'lllneed an Argon ONE case (or the forthcoming 
EON) to use the Argon IR 
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AUDIO 


FEATURES: 
Up to 

96kKHZ/ 32-bit, 
102dB SNR 
DAC, 92 dB 
SNR ADC, 
integrated DSP, 
3D effects and 
de-emphasis 


INPUT/ 
OUTPUT: 
Gold-plated 
3.5mm jack 
for mic or 
stereo out 


GPIO: 
Pass-through; 
GPIO pins used: 
2, 3, 18-21, 26 





Verdict 


If you needa 
separate audio 
output (and/or 


Berry 400$ 


> The Pi Hut » magpi.cc/dacberry400 > £17/5S19 


Add an gudio output, and mic input, to your 


Raspberry Pi 400. By Phil King 


hile Raspberry Pi 400 has an array of 
W ports at the rear, one notable omission 

is a dedicated socket for audio output. 
The DACBerry 400 S is designed to address this 
while also offering a mic input via the same gold- 
plated 3.5mm socket. 

The DACBerry 400 S fits onto the GPIO header 
at the rear of Raspberry Pi 400. While it’s fairly 
obvious which way up the board should go, care 
needs to be taken to line up its header with the 
GPIO pins correctly — with a small gap showing at 
the Pin 1 end. 

Get the alignment wrong and not only will you 
get no sound, but you may damage the board. This 
is something manufacturer OSA Electronics will 
be addressing in the second batch of boards, by 
introducing a small bump in the middle, to line up 
with a notch in the GPIO header surround. 


Let there be sound 

A one-line Terminal command installs the software 
needed to drive the DACBerry 400 S. At the time of 
writing, this required the earlier Buster version of 
Raspberry Pi OS (magpi.cc/buster), but it should 





A The DACBerry 400 S has a gold-plated audio connector 
and pass-through for the GPIO pins 


M™ Care needs to be taken 
to line up its header with 
the GPIO pins correctly @ 


be available in Bullseye soon. After rebooting, the 
audio will be routed through the DACBerry — with 
Raspberry Pi 400’s audio chip disabled, so it’s not 
easy to switch back if needed. It also works with 
OSMC and LibreELEC, among other OSes. 

The line-out audio signal is strong enough for 
decent volume on connected headphones, or you 
can use powered speakers or an amp. The sound 
quality is very good with a nice warm tone and 
strong bass, possibly due to DSP’s integrated low- 


mic input) for your 
Raspberry Pi 400, 
this provides one 
at little cost. 


8 i 
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pass filter. The audio can be adjusted using the 
numerous settings in alsamixer, but OSA plans to 
introduce a GUI-based tool for this. 

A bonus is the ability to connect a microphone 
for recording, using the same 3.5mm socket — OSA 
is also planning another DACBerry 400 model with 
a separate mic socket. Hl 





A Make sure to connect the board to the GPIO header the 
right way around and align the pins correctly 
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10 Amazina: 
Starter kits 


These Raspberry Pi kits will 
help you take the first steps 


on your making journey 
id you get a Raspberry Pi for Christmas? 

I) Maybe thinking of getting one with any holiday 
money you received? Here are some great kits 

to help you get properly started with a Raspberry Pi or 

Raspberry Pi Pico. Hl 








4 Picade 


Arcade kit 


This mini arcade cabinet is a wonderful kit that allows you to 
create a high-quality retro games console, with a nice stick and 
buttons which can be upgraded in the future if you wish. 


magpi.cc/picade | £225 / $249 
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4 Raspberry Pi 400 
Personal Computer Kit 





All-in-one Raspberry Pi 


A box full of just about everything you need to create a PC - a Raspberry Pi 400, 
mouse, power supply, microSD card, and a nice Beginners Guide book. Just add 
a monitor or TV. 


magpi.cc/pi400info | £94/$125 


v CamJam Edukit 
3 — Robotics 


th Beginner's robot 





art! A classic kit for beginners that lets 
you easily build and program a robot 
of your very own, and quite cheaply 
as well! You can even use the box as 
the chassis. 





4 Grow Kit 


magpi.cc/edukit3 | £18 / $24 


Automated herbs 


Growing your own herbs is a great 
way to not have to constantly buy 
fresh herbs for cooking, and the Grow 
Kit makes it very easy to keep them 
watered so they'll grow properly. 





magpi.cc/growkit | £30 / S40 


v Autonomous 
Robotics Platform 
for Pico 






Pico robot 


We're entering a new world of Pico robotics, 
and this Kitronik kit will get you going with 

it. Pico offers different advantages over NX 
Raspberry Pi for robots, so give it a look. 


magpi.cc/robotplatform | £41 / S55 
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4 Pico Explorer Base 


FRGtG RELY 


Pico playground 





This board allows you to really explore what can be done with a Pico, with 
plenty of stuff for beginners and loads of things you can then build up from, 
thanks to its breakouts and screen. 


magpi.cc/picoexplorer | £22 / S29 


4 Raspberry Pi Pico 
MicroPython Learning Kit 


More electronics 


This is basically a bigger version of the Discovery kit with many 
more components to play around with. It even comes with a Pico. 


magpi.cc/learningkit | £32 / $43 
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4 Discovery Kit for Raspberry Pi Pico 





Electronics and microcontrollers 


Loads of little electronics bits that you can use with a Raspberry Pi as well as 
Pico. It comes with a little guide with several projects too. 


magpi.cc/discoverykit | £12 / $16 





>» Monk Makes 
Project Box 1 





4 Grove Starter Kit for 
Raspberry Pi Pico 









Intro to electronics 


. Sensors and more 
With enough components to 


create ten projects, these Monk 
Makes boxes are a great way to get 
stuck in with a new Raspberry Pi. 


This kit is a great way to play around with sensors and motors and 
more without needing to worry to much about wires — just 
the programming. 





magpi.cc/projectbox1 | £12/$15 AUN | magpi.cc/groestarterkit | £44 / $59 
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Learn to code in Scratch 


Bright colours and an array of projects to get stuck into make Scratch 
the ideal first step into coding. By Rosie Hattersley 





Raspberry Pi Projects 





FS Raspberry Pi Raspberry Pi provides a So a 
E Foundation heap of projects and games 
Ly to help you get to know 
G Puce Scratch, complementing 
lve those offered by MIT. These 
magpi.cc/ projects challenge you to beat 
scratchprojects 





the buzzer, press particular keys 
corresponding to colours in 
order to create sounds, or to log 
how many birds of a particular 
hue appear in your virtual 
wildlife camera. 

The skills you learn can then 


JD LEG chess di pier with Sorwvich 











with code! Web-based Trinkets 
enable you to practise and check 


you’ll create, with lists of 
materials needed and details of 


be used for your own Raspberry 
Pi projects. Videos at the start 
of each project show you what 


how it all fits into educational 
learning goals. Of course, you 
can just enjoy making things 


sXe} #106) s MOLOLUNESTSIS 





Teach yourself or others with 
g bit of online assistance 


(Co FIRST 


A free computer science curriculum that makes 
coding easy to teach and fun to learn. 





A CS First is a great place to learn Scratch skills 
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COURSERA 

Coursera has a range of Scratch 
courses to help you learn the 

visual programming language. 

The “Introduction to basic game 
development course” is a great 
place to start, before moving on toa 
range of more advanced courses. 

> magpi.cc/courserascratch 


CS FIRST 

Learn Scratch skills yourself, as 
well as getting ideas and project 
plans for use in the classroom or at 
a coding club you might be involved 


your code works. Step-by-step 


instructions and diagrams are 
included throughout. 


with. Separate logins for individual 
students and educators mean that 
everyone can learn at their own 
pace, and backup resources are 
always on hand. 

> magpi.cc/csfirst 


UDEMY 

Ideal for teachers or individuals, 
classes are aimed at adults keen 
to learn coding in order to teach it 
to others. The course focuses on 
problem-solving, computational 
thinking, and creativity. 

> magpi.cc/udemyscratch 
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Learn along 
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scratch.mit.edu/ideas 
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Scratch ideas 





Scratch. Scratch is a visual 
means of learning to code and 
provides an accessible route 

to learning using images and 
animations. Importantly, the 
visual approach mimics the 
types of instruction you will 
encounter when using text- 
based coding languages such as 
Python to program Raspberry Pi, 
Arduino, and other computers. 


CS50 Scratch 





magpi.cc/cs50scratch 





programming. Most of the 
course materials cover text- 


@ 
x 





or character, after which you 
can jump Straight into using 
Scratch yourself. 

The basic premise of Scratch 
is that coding can be done by 


ordering physical actions. This is 


as simple as dragging the blocks 
you want to use over to the 


workspace, and then clicking the 


ereen flag to play each action. 
Brief video overviews introduce 
topics such as Making Music, 
Imagine A World, and Video 
Sensing, providing a good steer 
before you give each one a try. 
Learner and educator info cards 
keep you on track. 

Open Scratch 3 (under 
Programming in the accessories 
menu) and click on Tutorials, or 
visit Scratch online. Hl 


introduces computer concepts 
using visual programming. 

It’s a great mix, combining 
Harvard’s know-how, 
excellent video seminars, 
and deep explanations with 
Scratch’s easy-to-understand 
interface. The course covers key 
programming concepts such as 
functions, conditions, loops, 


variables, and abstraction. When 


you've finished you can move on 
to further CS50 courses. Hl 





Learn coding 
independently or as 


0G e e e ° ° 

<= MIT An ideal starting point for Start by watching the Getting part of a peer group 
= newcomers to coding, MIT Started video, which shows how 7 

= Price: (Massachusetts Institute of instructional blocks are used to a 

jy free Technology) is the home of build up actions for each sprite 


SCRATCHED 

Ideas for how to use Scratch 
across the curriculum, from 

music and maths to literacy 


and art. This site contains lots 


of ready-made quizzes and 
challenges, plus Scratch- 
based animations that precis 
important topics you want 
students to remember. 

> magpi.cc/scratched 


SCRATCH.IE 

A useful set of Scratch- 
based activities separated 
into primary school-age and 


post-primary (age 12 upwards, 


reflecting the Irish education 
system). As with other sites, 
teacher and students have 
their own login and learners 
can progress independently, 
choosing which projects to 
complete when. We'll be 


a Harvard CS50 is Harvard University’s based languages, such as heading straight to the retro 
= highly acclaimed introduction C, but this “Introduction to gaming option! 

Z Price: to computer science and programming with Scratch” > magpi.cc/scratchie 

eR free 


CODERDOJO 

Part of the Raspberry Pi 
community, CoderDojos 
provide both online projects 
you can complete, and in- 
person groups where you 
can join other young coders 
working on Scratch, Python, 
and HTML challenges. Click 
the Resources link for ready- 
made projects to try. 

> magpi.cc/coderdojo 
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> This model railway’s train 
signal is automated via 
Raspberry Pi 


Stewart Watkiss 


The Penguin Tutor 


> Name Stewart Watkiss | 


> Community role STEM Ambassador | 


tewart may be familiar 
S to long-time readers 

of The MagPi - he’s 
written articles for it and had 
his projects featured in these 
very pages many a time. He’s 
also a well-known face in the 
community, having been around 
since the beginning. 

“T became a member of the 
Raspberry Pi community from the 
launch of the first Raspberry Pi,” 
Stewart tells us. “I couldn’t wait 
to get my hands on one. Being a 
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> Occupation Data Centre Manager 


member of the community has 
opened new doors for me; it’s 
given me an opportunity to make 
projects which were previously 
out of reach, to teach skills to 
others, and fulfil my ambition of 
writing a book.” 


What is your history with 
Raspberry Pi: 

As a supporter of Linux, I first 
heard about Raspberry Pia few 
days before the launch. I heard 
it was a new low-cost Linux 





> Website penguintutor.com 


computer, and wanted to get 
hold of one. I was up early on 
the day of the launch, but didn’t 
manage to place an order until 
later that day when the retailers’ 
websites had recovered. It was 
then a few months’ wait before 
it was delivered. Once I had one, 
it became clear that it was much 
more than just a Linux computer, 
and the GPIO connectors 

meant that I could use it for so 
much more. 

I created some initial projects 
and then got involved with more 
community events, giving talks 
and workshops at Raspberry 
Pi events, including some in 
Cambridge and those nearer 
home at Birmingham. 

I also signed up as aSTEM 
ambassador, and I’ve run some 
Code Clubs in schools. 


How long have you been 
making for? 

I started getting interested in 
making during the early 1990s 
whilst studying electronics. 
After finishing university, | 

no longer had access to the 
equipment needed to go beyond 
basic projects, so 1 dropped the 
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SSS 
A The Bee Box was one of the first projects Stewart made with Raspberry Pi, A This 3D-printed house had lights controlled 
working with his kids on it via a Raspberry Pi and touchscreen 
hardware side and concentrated it was, and it was valuable 
more on software projects. experience for when I got my first F 
I bought my first Arduino in book deal. Stewart's stuff 
2008, which made electronics 
much easier and expanded What is your favourite thing ~ 
the scope of what the home that you’ve made with a saa eas 
re y ; (or three if you count the 
electronics enthusiast could Raspberry Pi? second edition). The first 
achieve. I started to get back My favourite project is one of is Learn Electronics with 
into electronics, working on my first, known as the Bee Box. Raspberry Pi, which has 
some simple projects. It was This was the first project that I cre saad vane 
, ; , Chinese, and Beginning 
really in 2012 when I first got did with my children, and I really Game Programming 
my first Raspberry Pi when my enjoyed that we were able to work with Pygame Zero which 
making took off. I started with together on it. It was a minibeast was published in 2020. 
some simple projects and then project for school using some More recently, I've been 
it grew from there, learning new reed switches to determine the eee oa cleaung 
; 8 ” 8 - content for my YouTube 
skills and progressing to more position of a model bee. It then channel, penguintutor, 


and website.” 





adventurous projects. Since then, showed a picture on the screen 
I’ve now got a 3D printer as well, and included sound effects. Hl 
which has expanded the scope of 
what I’m able to do. 





Could you tell us about writing 
for The MagPi in the early days? 
I wrote a few articles for The 
MagPi when it was a purely 
volunteer magazine. I took 

some projects that I’d created 
already and created a write- 

up for the magazine. At the 

time, I was wanting to write a 
book and writing for The MagPi 
Was a great way to get more 
experience. Despite being written 
by volunteers, it followed all the 
Same process as a professional 
publication, including a technical 
review and proofreading. I was 
impressed by how professional 
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(i) Or Footlag - Robotedr 
aorfootiog 


Fe Rares Deo GOT Poa ag 





| designed and 3D printed a case for my new Pi Zero 2 
W and the Pi camera which mount on aluminium 
extrusion, then set it up running OctoPrint on my 
3DPrintMill. 

(Pi case was remixed from an original idea posted by 
Emily Murry on grabcad.com/library/raspbe... ) 
#MagPiMonday 






MagP1 
Monday 


Amazing projects direct from our Twitter! 





very Monday we ask the question: have you 


made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 


they’ve made. 


Here’s a selection of some of the awesome things we 
got sent this month, and we got quite a lot! Remember 
to follow along at the hashtag #MagPiMonday! HI 





01. 


02. 


03. 


04. 


05. 


06. 


07. 


08. 


09. 


10. 


We love a bit of OctoPrint here, and this 
is a great use of Raspberry Pi Zero 2 W/ 
by Dr Footleg. 


We'd have to do some maths to figure 
out Just how much more powerful this 
Zero 2 W array would be - orders of 
magnitude at least. 


This is an interesting console idea, which 
seems to have taken some inspiration 
from the Switch. 


As long as there are ultrasonic sensors 
attached to Raspberry Pi, there will 
be theremins. 


The recycling of this drift wood into a tide 
indicator is very cool. 


Open-source farming robot is an excellent 
combo of words - we're keeping our eye 
on this! 


The bare mental synth project keeps growing. 


Lorraine always comes up with great and fun 
projects, and this is no different. 


This cute plushy night light is something that 
should exist as a product, we think. 


Getting readings to look good and be 
informative at a glance is an art in itself. 
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02 


Rephying to @TheMaeri 





Hmagpimonday no Christmas decorations yet - but i 
am building a Clustered-Pi based on the Cray-1 super 
computer from 1976. #cluster #raspberrypi 
#raspberrypizero? #ansible #opensource #stem 
#3dprint #3Dprinting 


Stewart Watkias 


etewartwataiss 


Hieenl ying to ] eMart 





| received a hardware preview of the PIP. #RaspberryPi 
based handheld games console for retro games and 
budding games developers. 







A bit limited at the moment (waiting on software 
updates), but I've been taking a look at the hardware. 


penguintutor.com/news/raspberry... 


#MagPiMonday 
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> \ Kevin McAleer 
' @kevemac 04 





Working on my tide level and direction drift wood 
integration 





Replying to @TheMagPi 








I've created a raspberry pi zero 2 based theremin using 
two range finders and a few lines of python (link in bio 
to the video) #MagPiMonday #raspberrypi #python 
#opensource #STEM 








188 bea **ee. 






Y art diyalactromusic 
eS @dyelectroamusic 


Rep Vir to ST heMagPi 


I've added PWM audio output to my (original) Pi Zero to 
use with my "bare metal" synth. 















Lorraine Underwood 
PO RA | rechibercecetl 







#MagPiMonday 














Taylor Alexander 


FT Leta rece 


hephang to @TheMagri 








ectromusic.wordpress.com/2021/11/12/ras... I'm creating an interactive light up window for my 


irre <a + neighbours/passing strangers to play with! It's got a 
Sea Poor .o7 VARGO .f. Oy micro:bit on the outside controlling buttons. Inside is a 
; free © raspberry pi connecting to and controlling the lights. 


+ 








Remind to 2) hehage 


Yes! | am doing a major new rev of the motherboard for 
our raspberry pi powered open source farming robot! It 
will be open source (done in Kicad) once | am done 

with it. 










i] Lorraine Undenaaed 2. MicUindee wood . Mow 14 

My ernlcroolt Fragphiryol inveracthat ligne up vitae ls working! [im sguiening, 
Che Wines Gehan ony hands 2s Cae Buttons, not chp sersors! Aust regs 
Eeecel Birra bo the wall ard 16 be mace pretty 


> 














a Taylor Alexander Ga OT LAbexande «Mov 12 
Getting much closer now. Showing tea videws of the main board, than the serial 
board and the power distribution board. BDU switch is out of stock tho eo | have 
1o rework that to whe P chancel MOSRETS. Wil do a full BOM sicck check (ane 
order!) before going to fab. twitterncooy TLalexandery' st 
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Repaying to OTheMagr 
I've been working on this Raspberry Pi Zero 2 W based 
#LoRaWAN CO? sensor node for @thethingsntwrk. 
The Python code still needs a little tweaking to make 


Gy Amanda Haughs the information on the #5501306 OLED easier to read. 









@MsHaughs #MagPiMonday #Hlol #stem Hopendata 
#oitizenScience 











Replying to ©TheMagPi GD TAO Gea) Concuting - how 2X) 
Reb yell. Wee-haw Bullseye! PTS i reach for ite renamite al readings from 


Finished my Pico Plushy for baby boy! Fun project & Geontirion SCD40 COD-coneer at Nopendata via @thethingertwikete 


ocinbonbernap. 








87 TN VS a1 Ravan neck beaded on Rasberry Pi Pte? ei Acatruit 
FLoRa Racie Boanet. SMINT MOT BO Rood eSoDe 
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. Kevin MeAleer 
@kevsmac 







Replying to @iTheMapPi 






This weekend I've been working with the Raspberry Pi 
Pico and RFID tags and MicroPython - video here! 
youtu.be/hV9GTqXLMps #MagPiMonday 
#Hraspberrypipico #pico #raspberrypi #robots 
#robotics #micropython #smallrobots #stem 
H#opensource 










Andrew Porter 


de tsdoor 








Replying to @TheMagPi 


Pico inside (tm) 






Pr i@ictewarlwatkics 


Replying to @TheMagP 











Christmas lights are not up yet, here is last years. 
Controlled using Pi with Energenie remote control 
sockets. 







saves climbing under the tree to get to the sockets. 
Lights turn on and off automatically. 
Manual override using a Pi touch screen. 













2 youtube.com 
Christmas light controlled by Raspberry Pi. Home automat... 
This video explains about the Christmas lighting display | 

have at my houpe and how it's controlled using 3 Raspberry... 










0:05 1K views 





After a break from all things Pi for a while, | finally 
finished a build i've wanted to do for about 6 years - a 
#raspberryp| based central heating thermostat. 
Includes Timer, thermostat, monitor and data logger! 
Plus you could probably play games on it too! 







11. We're up pondering this orb. 


12. RFID and robotics is a great combo, as 
it can help automate movement. 


13. Send us your Christmas projects when 
you've finished them, we'd love to see! 


14. This thermostat design is very nice, 
and we hope it helps keep Mark warm 
throughout the winter. 
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Best of the rest! 


Other stuff we've seen this month from the community 


SCIENCE BY SOLAR 


We've covered collaborative computing in 
the past with software like BOINC, which lets 
you donate PC power to help with protein 
folding or data analysis of some kind for 
scientific projects. Jamie emailed us about his 
Science by Solar project, which is a Raspberry 
Pi Zero running entirely off solar power that 
connects to the World Community Grid. 

The website for his particular project 
is even run off this solar-powered Zero 
(sciencebysolar.me), and shows stats for 
what its currently working on. 

“Although this tiny system's contribution 
is small, my goal was the create a self- 
sustaining solar computer that actually had 
some reasonable use,” the website states. Protein ta rget 
“The calculations this system performs do 


actually contribute to real research and real Candidate bein g evaluated 
results - just slowly in this case." 





PICOMITE: BASIC COMPILER 


Another email we got this month was from Peter 
about a compiler for BASIC on Raspberry Pi 

Pico. For those a bit younger, BASIC is an earlier 
language used mostly in the 1980s and early 
1990s. Having something like Pico run a compiler 
for it is very impressive, allowing you to actually 
program Pico in BASIC itself. 

“Using MMBasic, you can use communications 
protocols such as |2C or SPI to get data froma 
variety of sensors,” the project website reads. “You 
can save data to an SD card, display information 
on colour LCD displays, measure voltages, detect 
digital inputs, and drive output pins to turn on 
lights, relays, etc. All from inside this low-cost 
microcontroller.” Find out more about it here: 
magpi.cc/picomite. [] 
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P Features Ed Rob's Dutch 
family enjoy seeing this 
version of The MagPi 
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< Bullseye Is the 
recommended version 
of Raspberry Pi OS, but 
nothing Is stopping you 
using an older version 








Buster or Bullseye? 


I’m working on a new project, and I was wondering whether or not to use the new 
Bullseye version of the OS or stick with Buster for now as I know it? 


Alex via Facebook 


Generally, Bullseye is very similar to Buster, so you shouldn’t have many issues having to 
learn anything new -— mostly it’s software updates and security fixes. Some projects may 
work a little smoother on Buster though, especially ones that involve the camera. For that, it 
might be better to use the new Legacy version of Raspberry Pi OS. You can find a copy in 
Raspberry Pi Imager and read all about it on Raspberry Pi's website (magpi.cc/legacy). 
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The MagP! translated 


I’ve been subscribed to the 
Dutch version of the magazine 
for several months and love 
getting it. I have a subscription 
query though, who should I 
contact? Are they the same 
people I should contact if I have 
a project to show: 


Mo vig Email 


Each of the translated versions 
of The MagPi have specific 
contact forms on their website 
(magpi.nl, magpi.fr, magpi.de, 
etc.) and they are the best places 
to go about your subscription to 
them. As for submitting projects, 
you can definitely send them our 
way, and they will eventually 
make their way into the 
translated editions! 


OR ALL ear 








@asPBERRY PI ZERO? F 


I saw that there was a pop-up Raspberry Pi Store in 
London recently. Do you have any other plans for pop- 
ups, maybe in other countries? 


Dana vid Twitter 


Unfortunately there are no plans, that we know of, for other 
pop-up versions of the Raspberry Pi Store. However, that’s 
the nature of pop-ups really! If there is enough demand, I’m 
sure the team will keep note in case the opportunity arises. 
Never say never! 
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The two-day London pop-up looked very swish 


Twitter 
Facebook 


Email 
Online Email: 


The only guide you 
THE OFFICIAL need to get started 
with Raspberry Pt 












How to use your 


new computer * Learn how to set up your Raspberry Pi, 


install an operating system, and Start using it 


* Follow step-by-step guides to code your 
Own animations and games, using both the 
Scratch 3 and Python languages 


* Create amazing projects by connecting 
electronic components to Raspberry Pi’s 
GPIO pins 


£10 with 
worldwide delivery 
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PICOSYSTEM 


CONSOLES! 
IN ASSOCIATION 
WITH PIMORONI 
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The amazing PicoSystem 

is a great handheld system 
powered by RP2040 that lets 
you prototype and play games 
quickly. Last month we gave 

it 9/10, and now you have a 
chance to win one of five. 





Head here to enter: magpi.cc/win | Learn more: magpi.cc/picosystem 





Terms & Conditions 


Competition opens on 15 December 2021 and closes on 27 January 2022. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Tre trials of running 
a modern arcade 
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Night School Studio talk exclusively about 


2022's most anticipated indie sequel 
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NEXT MONTH 


27 JANUARY 


DON'T MISS OUT! 
magpi.cc/subscribe 











EDITORIAL 
Editor 

Lucy Hattersley 
lucy@raspberrypi.com 


Features Editor 
Rob Zwetsloot 
rob@raspberrypi.com 


Sub Editor 
Nicola King 


ADVERTISING 

Charlotte Milligan 
charlotte.milligan@raspberrypi.com 
+44 (0)7725 368887 


DESIGN 


criticalmedia.co.uk 


Head of Design 
Lee Allen 


Designers 
Olivia Mitchell. Sam Ribbits, 
Ty Logan 


Illustrator 
Sam Alder 


CONTRIBUTORS 


David Crookes, PJ Evans, 
Rosemary Hattersley, Richard 
Hayler, Nicola King, Phil King, 
Rob Miles, David Plowman, 
Nik Rawlinson, Marc Scott 


PUBLISHING 


Publishing Director 
Russell Barnes 
russell@raspberrypi.com 


Director of Communications 
EZ wolom 


CEO 
Eben Upton 


DISTRIBUTION 


Seymour Distribution Ltd 
2 East Poultry Ave, 
London EC1A 9PT 

+44 (0)207 429 4000 


SUBSCRIPTIONS 


Unit 6 The Enterprise Centre 
Kelvin Lane, Manor Royal. 
Crawley, West Sussex, RH10 gPE 
+44 (0)1293 312193 
magpi.cc/subscribe 
magpi@subscriptionhelpline.co.uk 








This magazine is printed on paper sourced 
from sustainable forests and the printer 
operates an environmental management 
system which has been assessed as 
conforming to ISO 14001. 


The MagPi magazine is published by 
Raspberry Pi (Trading) Ltd., Maurice Wilkes 
Building, St. John’s Innovation Park, Cowley 
Road, Cambridge, CB4 ODS. The publisher, 
editor, and contributors accept no 
responsibility in respect of any omissions 
or errors relating to goods, products, or 
services referred to or advertised in the 
magazine. Except where otherwise noted, 
content in this magazine Is licensed under 
a Creative Commons Attribution- 
NonCommercial-ShareAlike 

3.0 Unported 

(CC BY-NC-SA 3.0). 

ISSN: 2051-9982. 


agri | THE FINAL WORD 





Decade 





2022 marks g decade of Raspberry Pi, How things 


hen I first heard about 
W Raspberry Pi, it was late 
2011 and the technology 


landscape was quite different. The 
Motorola Atrix and Xoom were the 
premier Android phones, iPhone’s 
signal went wonky if your finger was 
in the wrong place, and the Xbox 360 
and PS3 were about halfway through 
their quite extended life cycle. With 
months until Netflix streaming 
would hit the UK, I was reading 
about the upcoming Raspberry Pi 
and getting pretty interested. | 

had no idea what I could use it for, 
but I knew I could definitely use 

it for something, even if a Twitter 
acquaintance thought it would 

flop like the Ouya (they have since 
deleted the tweet, ending with ‘it 
doesn’t even have a battery’). 

When Raspberry Pi came out, I had 
just started writing for a long defunct 
Linux magazine at a now dead 
publisher, and we were immediately 
enthralled. I spent years writing 
tutorials using a 250MB Raspberry 
Pi 1 Model B - turning Raspberry 
Pi into robots, media centres, file 
Servers, routers, BOINC nodes, and 
much more. One day, I even managed 
to break the entire office LAN 
while playing around with network 
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settings, oops. It was a lot of fun 
though, and I learned loads doing it. 


Late bloomer 

I was one of the kids that grew up in 
the late nineties and early noughties 
who experienced the loss of proper 
computing lessons at schools, so to 
be able to learn to code and learn 
practical programmable electronics 
in my twenties was a huge thing for 
me. It’s one of the reasons I landed 
on The MagPi in 2015, and more 
importantly, the reason | have 
stayed for around 80 issues. 


f™ The passion of the 
community that first 
year was electric @ 


Seeing the passion of the 
community that first year was 
electric. When we put out issue 40 
with Raspberry Pi Zero on the cover, 
we thought it might be popular, but 
we didn’t realise just quite how 
popular. It took about a week for the 
constant stream of messages from 
people wanting to get acopy to die 
down, and it took years for us to 


nave changed. By Rob Zwetsloot 


stop getting messages asking if we 
had any left at all. 

Since then, I’ve been through 
many things with Raspberry Pi. The 
launch of Raspberry Pi 3, the AIY 
Vision Kit we did with Google, 
sending Raspberry Pi to space, new 
cameras, Raspberry Pi 4, Raspberry 
Pi 400, Raspberry Pi Pico, and 
recently Raspberry Pi Zero 2 W, just 
to name a few. 


Now where? 

As the second decade of Raspberry Pi 
looms ahead, my enthusiasm hasn’t 
died down a bit. I still get new ideas 
every month for something to do with 
Raspberry Pi, and I will never cease to 
be amazed at the creativity of the 
community and how much they’ve 
supported us over the years. I'll be 
right here with you to see what 2022 
brings to Raspberry Pi, and the ever- 
changing world it’s helping. Hl 


Rob Zwetsloot 





Rob is nearly 35 and has decided that 
makes him very old, despite being born 
the same year as Star Trek: The Next 
Generation started. 
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Displays Cases Project Kits Add-on Boards 
HATs Arcade Cameras Cables and Connectors 
Sensors Swag Power Options GPIO and Prototyping 


Partner and official reseller for top Pi brands: 


) . | , s | and many 
adatrui Sparkfun.. = P|IMORON! Gi HiFi sae! 








PiShop.us 














HIGHP!] PRO 


-— — The new case from the HIPI.iIo team —————-- 





Ziyi Ly 


® Rapid tool-free assembly and disassembly ® Secure microSD card cover 

® Large internal volume for HATs @ VESA mount support 

® Compatible with Pi 2/3/4 ® Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

® Passive & Active Cooling options @ Printed logo for your branding 


| Available at these great Pi stores: 


ew td baled “hs | 
€PiShop.us {*fPiShop.ca {*fPiShop.mx €zPiHut PrSioe.ch Welectron. 


Contact your favorite Pi store if it’s not listed here 





